Objektkopie

Syntax

$orig.copy()

copy(orig: $orig,
	context: $context, 
	filter: $filter, 
	constructor: $constructor, 
	transient: false)

Beschreibung

Erstellt eine tiefe Kopie des Objektes bzw. eine einfache Kopie des Wertes orig.

In einer tiefen Kopie eines Objektes sind alle über Kompositionsreferenzen erreichbare Objekte ebenfalls mitkopiert. Andere Referenzen in dem kopierten Objektgraphen sind auf Objekte in dem neuen Graphen umgesetzt, wenn sie im ursprünglichen Graphen auf ein Objekt zeigten, das bei der Kopieroperation mitkopiert wurde.

Parameter

Name	Typ	Beschreibung	Pflicht	Default
orig	Zahl/Zeichenkette/Wahrheitswert/Fachobjekt/Menge	Das zu kopierende Objekt bzw. der zu kopierende Wert.	ja
context	Fachobjekt	Das Kontext-Objekt, das bei der Anlage der top-level Kopie (von `orig`) mitgegeben wird.	nein	null
filter	Funktion	Entscheidet, ob eine bestimmte Eigenschaft aus dem Ursprungsgraphen mitkopiert werden soll. Die Filter-Funktion erhält drei Argumente. Das zu kopierende Attribut. Die zu kopierende Instanz aus dem Ursprungsgraphen. Die Kontext-Instanz, an der das zu kopierende Attribut definiert ist. Ist die Entscheidung `true`, so wird das Attribut vom Ursprungsobjekt in das Zielobjekt kopiert. Ist das Attribut eine primitive Eigenschaft, wird der Wert direkt in das Zielobjekt übernommen. Ist das Attribut eine Referenz, wird diese Referenz entweder direkt übernommen, oder in den Zielgraphen umgeschrieben, je nachdem, ob das Ursprungsobjekt in der Kopieroperation kopiert wurde oder nicht. Ist das Attribut eine Komposition, wird eine tiefe Kopie des Ursprungsobjektes angefertigt. Ist die Entscheidung `false`, so bleibt das Attribut im Zielobjekt uninitialisiert. In diesem Fall, könnte die Konstruktorfunktion für dieses Attribut einen Standardwert ausrechnen und zusammen mit der Konstruktion setzen.	nein	`attribute -> orig -> context -> true`
constructor	Funktion	Eine Funktion, die ein Objekt aus dem Ursprungsgraphen nimmt und eine (uninitialisierte) Kopie dieses Objektes zurückliefert. Die Funktion erhält drei Argumente: Das zu kopierende Originalobjekt. Die Kontext-Referenz, über die das Originalobjekt mit seinem Kontext verknüpft ist (`null`, für die top-level Kopie). Das originale Kontext-Objekt, das das zu kopierende Originalobjekt in seiner Kontext-Referenz hält. Liefert die Konstruktorfunktion `null`, wird ein Objekt vom selben Typ wie das Original angelegt.	nein	`orig -> reference -> context -> null`
transient	Boolean	Ob die Kopie ein transientes Objekt anlegen soll. Diese Option ist nur relevant, wenn keine Konstrukturfunktion angegeben ist. Wenn nichts angegeben ist (`null`), werden transiente Objekte als transiente und persistente als persistente kopiert. Transiente Objekte sind nur lokal in der Session des Benutzers sichtbar und können nicht in die Referenz eines persistenten Objektes gespeichert werden. Umgekehrt kann aber ein transientes Objekt in seinen Referenzen normale persistente Objekte referenzieren.	nein	`null`

Rückgabewert

Typ: Zahl/Zeichenkette/Wahrheitswert/Fachobjekt/Menge

In Abhängigkeit vom Typen von x wird folgendes von der Funktion zurückgeliefert:

Referenz auf ein Fachobjekt: eine tiefe Kopie dieses Objektes.
Liste: eine Liste, in der alle Fachobjekte durch tiefe Kopien ersetzt sind.
alle anderen Werte: der Wert selbst.

Beispiele

Objektkopie

{
   a = new(`my.module:MyClass`);
   $a.set(`my.module:MyClass#name`, "orig");
   b = $a.copy();
   $b.set(`my.module:MyClass#name`, "copy");
   list($a, $b);
}

Ausgabe: Gibt eine Liste mit dem originalen und dem kopierten Objekt aus: [orig, copy]

Objektlistenkopie

{
   a = new(`my.module:MyClass`);
   b = new(`my.module:MyClass`);
   list = list($a, $b);
   $list.copy();
}

Ausgabe: Eine Liste mit Kopien der Objekte a und b.

Wertekopie

{
   a = 5;
   b = $a.copy();
   list($a, $b);
}

Ausgabe: Eine Liste mit den Werten [5, 5] - ein Mal die originale Zahl und ein Mal die kopierte.