Insert

Insert(zugriffsAusdruck), Insert(zugriffsAusdruck, backRef), Insert(STACK, STACK)

Parameter: access path, back reference name.

Stack
Stack	Position	Description
Stack(In)	top	target object
	top-1	object to be inserted
Stack(Out)	top	-

The stack top 1 object Das Objekt aus Stack-Top-1 wird in die - ausgehend vom Zielobjekt - über den Zugriffsausdruck erreichte Collection c eingefügt. Both objects need to be either transient or persistent. In case the collection that has been selected in the target object has been declared in the DDI as a m-1- or a m-m reference, the back-reference name has to be indicated as a second operand. the backreference (pointer or collection) will be set after checking the type indicated in the DDI. Insert will be controlled by DDI entries and gets interrupted with an error, when trying to gesteuert und bricht mit einem Fehler ab, wenn versucht wird, eine der im DDI getroffenen Festlegungen zu verletzen. This is the case, if

the data type of the object to be entered does not match the reference data type in the DDI (the object is no instance for the DDI class or for any derived one)
the object o with collection c doesn't match the BackReference data type that has been entered in the DDI (the object is no instance for the DDI class or for any derived one) (object o is no instance keine Instanz der im DDI als Backreference-Typ eingetragenen oder einer davon abgeleiteten Klasse)
die zum Beginn der Operation vorgefundene Referenz hinsichtlich Hin- oder Rückreferenz einen Typwiderspruch zum DDI enthält
bei einer m-1-Relation die Rückreferenz gar nicht auf Objekt o zeigt
bei einer m-n-Relation Objekt o kein Element der Backreference-Collection ist.
Mit [ O1, O2, ..., On ] Ox Insert(coll, backRef) werden die Objekte O1, ..., On in die - über Objekt Ox erreichte - Collection coll eingefügt:

Attention!
outdated, please use Link

Stack
Stack	Position	Description
Stack(In)	top	target object
	top-1	]
	top-2	On
	. . .	. . .
	top-n-1	O1
	top-n-2	[
Stack(Out)		-

Insert

Stack
Stack	Position	Description
Stack(In)	top	collection
	top-1	object to be inserted
Stack(Out)	top	-

The stack top 1 object gets inserted into the stack top collection.

Attention!
This form of an Insert statement can't be applied to collections, that belong to a 1-n- or m-n relation in the DDI (see Example).

[ O1, O2, ..., On ] coll Insert inserts the objects O1, ..., On into the collection from the stack top (reversed!):

Stack
Stack	Position	Description
Stack(In)	top	collection
	top-1	]
	top-2	On
	. . .	. . .
	top-n-1	O1
	top-n-2	[
Stack(Out)		_

Information: In case of a persistent object, a transaction starts.