Syntax

	$object.copy()

$object.copy($context, $filter, $constructor)

Beschreibung

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

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
object Zahl/Zeichenkette/Wahrheitswert/Fachobjekt/Menge Das zu kopierende Objekt bzw der zu kopierende Wert. ja
context Fachobjekt Das Context-Objekt, das bei der Anlage der top-level Kopie (von object) 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

Rückgabewert

Typ: Zahl/Zeichenkette/Wahrheitswert/Fachobjekt/Menge

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

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.