Using Caché Objects - InterSystems Documentation

Using Objects with Caché ObjectScript
the pet in the third slot in the list of pets owned by a person to a new dog using the following
code:
Do per.Pets.SetObjectAt(DogOid,3)
where per is the OREF of the Person object and DogOid is the OID of the Dog object.
You can insert an object into slot n using the following syntax:
Do oref.PropertyName.InsertObjectAt(ItemOid,n)
where oref is the OREF of the specific object to associate the data with, PropertyName is the
name of the list property, and ItemOid is the OID of the object. Again, insert a new list item
increments the value of all previously-existing list items. For example, you can add a new
dog to the beginning of the list of pets owned by a person using the following code:
Do per.Pets.InsertObject(DogOid,1)
where per is the OREF of the Person object and DogOid is the OID of the Dog object.
10.4.3.4 Modifying Properties of Objects in Lists
Once an object has been associated with a particular slot, you can modify its properties as
follows:
Set oref.PropertyName.GetAt(n).ListPropertyName = data
where oref is the OREF of the object containing the list; PropertyName is the name of the
list property; the GetAt method finds and returns the value of the element specified by n; n
is the slot in the list containing the object to update; ListPropertyName is the property to
update; and data is the actual data to associate with the property.
For example, to set the name of a person' s second pet, use the following code:
Set per.Pets.GetAt(2).Name = "Rover"
where per is the OREF of the Person object and Rover is the name of the pet.
10.4.4 Modfiying Array Properties
Arrays are unordered collections of information (unlike lists, which are ordered). An array
consists of one or more name-value pairs, where the name of the element serves as a key and
the value is data associated with that key. There is no syntactic difference between adding a
new element and changing the data contained in an existing element.
78 Using Caché Objects