This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRISOpens in a new window, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions pageOpens in a new window (login required).

Caché & Ensemble 2018.1.5Opens in a new window > Class Reference > %SYS namespace > %Collection.Super

%Collection.Super

class %Collection.Super extends %Library.RegisteredObject

Functions needed for all collection classes

Property Inventory (Including Private)

Method Inventory (Including Private)

Parameters

parameter ELEMENTTYPE = %String;
The type (class name) of the elements stored in the collection.

Properties (Including Private)

property ElementClassType as %String;
The ClassType of the elements stored by this collection
Property methods: ElementClassTypeDisplayToLogical(), ElementClassTypeGet(), ElementClassTypeIsValid(), ElementClassTypeLogicalToDisplay(), ElementClassTypeLogicalToOdbc(), ElementClassTypeNormalize(), ElementClassTypeSet()
property ElementType as %CacheString [ InitialExpression = ..#ELEMENTTYPE ];
The type (classname:propertyname) of the elements stored in the collection.
Property methods: ElementTypeGet(), ElementTypeIsValid(), ElementTypeSet()
property LiteralBehavior as %Integer [ InitialExpression = 0 ];
True if this collection is a 'literal object' so the Insert/Set should make a copy of the object before inserting it.
Property methods: LiteralBehaviorDisplayToLogical(), LiteralBehaviorGet(), LiteralBehaviorIsValid(), LiteralBehaviorLogicalToDisplay(), LiteralBehaviorNormalize(), LiteralBehaviorSet()
property OrefStorage as %Integer;
Property methods: OrefStorageDisplayToLogical(), OrefStorageGet(), OrefStorageIsValid(), OrefStorageLogicalToDisplay(), OrefStorageNormalize(), OrefStorageSet()
property Owner as %String;
Integer version of the object that has the collection data
Property methods: OwnerDisplayToLogical(), OwnerGet(), OwnerIsValid(), OwnerLogicalToDisplay(), OwnerLogicalToOdbc(), OwnerNormalize(), OwnerSet()
property ReadOnly as %Boolean;
True if this collection is read only
Property methods: ReadOnlyDisplayToLogical(), ReadOnlyGet(), ReadOnlyIsValid(), ReadOnlyLogicalToDisplay(), ReadOnlyNormalize(), ReadOnlySet()
property Storage as %Integer;
Property methods: StorageDisplayToLogical(), StorageGet(), StorageIsValid(), StorageLogicalToDisplay(), StorageNormalize(), StorageSet()
property StreamLocation as %String;
For stream collections this contains the stream root location
Property methods: StreamLocationDisplayToLogical(), StreamLocationGet(), StreamLocationIsValid(), StreamLocationLogicalToDisplay(), StreamLocationLogicalToOdbc(), StreamLocationNormalize(), StreamLocationSet()
property oidData as %String [ Private , MultiDimensional ];
If the collection is disconnected this is where the oid data is stored
Property methods: oidDataDisplayToLogical(), oidDataGet(), oidDataIsValid(), oidDataLogicalToDisplay(), oidDataLogicalToOdbc(), oidDataNormalize(), oidDataSet()
property orefData as %String [ Private , MultiDimensional ];
If the collection is disconnected this is where the oref data is stored
Property methods: orefDataDisplayToLogical(), orefDataGet(), orefDataIsValid(), orefDataLogicalToDisplay(), orefDataLogicalToOdbc(), orefDataNormalize(), orefDataSet()

Methods (Including Private)

method %Disconnect() as %Status
Called when the parent object is about to be removed so this collection can exist in a disconnected state. It makes a copy of the parents collection information.
method %IsModified() as %Integer
Inherited description: Returns true (1) if a property of this instance has been modified, otherwise false (0). A TRUE result does not necessarily mean that any property has actually been changed. If %IsModified() returns false then the object has not been modified. There are some situations where we simply cannot efficiently detect a change in value. In these cases we will set the modified status of the property.
private method %OnConstructClone(object As %RegisteredObject, deep As %Boolean = 0, ByRef cloned As %String) as %Status
Inherited description: This callback method is invoked by the %ConstructClone() method to provide notification that a clone of an object is being created. It passes in the oref of the object that was cloned in object.

If this method returns an error then the object will not be created.

method %SetModified(val As %Boolean) as %Status
Inherited description: Setting the modified state of the object.
method Clear() as %Status
Clears the contents of the array. Both the OID value is cleared.

Returns a %Status value indicating success or failure.

abstract method DeSerialize(serialized As %String(MAXLEN="")) as %Status
Deserialize from string created with Serialize() back to collection
abstract method Serialize(force As %Integer = 0) as %String
Serialize constructs a serialized form of the collection as a string

Inherited Members

Inherited Methods (Including Private)

Subclasses

FeedbackOpens in a new window