storeCopy()

Die Systemfunktion 'javaLib.storeCopy()' erstellt eine neue Kennung auf Basis einer anderen Kennung im Objektbereich, sodass beide Kennungen auf dasselbe Objekt verweisen. Wenn die Quellenkennung nicht im Objektbereich vorhanden ist, wird für die Zielkennung eine Null gespeichert. Es tritt kein Fehler auf. Ist die Zielkennung bereits im Objektbereich enthalten, ist die Aktion äquivalent zu den folgenden Schritten:

Weitere Informationen zum EGL-Java™-Objektbereich, in dem 'javaLib.storeCopy()' und ähnliche Funktionen ausgeführt werden, finden Sie im Abschnitt Java-Zugriffsfunktionen. EGL verwaltet diese Methode für Java-Zugriff zwecks Kompatibilität mit früheren Versionen. Verwenden Sie für neuen Code die leistungsfähigere ExternalType-Syntax. Weitere Informationen finden Sie im Abschnitt ExternalType-Abschnitt.

Syntax

  javaLib.storeCopy(
    Quellen-ID javaObjId in,
    Ziel-ID javaObjId in)
Quellen-ID
Eine von der Groß-/Kleinschreibung abhängige Kennung, die auf ein Objekt im Objektbereich oder auf null verweist. Bei der Eingabe kann es sich um eine beliebige Variable oder einen beliebigen Ausdruck handeln, die/der mit dem Typ STRING zuordnungskompatibel ist und in 'objID' umgesetzt wird. EGL schneidet Einzel- und Doppelbyteleerzeichen am Anfang und Ende des Argumentwertes ab.
Ziel-ID
Die neue, von der Groß-/Kleinschreibung abhängige Kennung, die auf dasselbe Objekt wie 'Quellen-ID' verweist. Bei der Eingabe kann es sich um eine beliebige Variable oder einen beliebigen Ausdruck handeln, die/der mit dem Typ STRING zuordnungskompatibel ist (siehe 'Zuordnungskompatibilität in EGL') und in den Typ 'objID' umgesetzt wird, wie in einem späteren Beispiel gezeigt wird. EGL schneidet Einzel- und Doppelbyteleerzeichen am Anfang und Ende des Argumentwertes ab.

Beispiel

Im folgenden Beispiel wird sourceId in ein neues Objekt im EGL-Objektbereich kopiert.

  javaLib.storeCopy("sourceId" as "objID:java", 
                    "targetId" as "objID:java");

Feedback