remove()

Die Systemfunktion 'javaLib.remove()' entfernt die angegebene Kennung aus dem EGL-Java™-Objektbereich. Das Objekt, das zur entsprechenden Kennung gehört, wird ebenfalls entfernt, jedoch nur dann, wenn keine anderen Kennungen auf dieses Objekt verweisen. Wenn eine andere Kennung auf das Objekt verweist, verbleibt das Objekt im Objektbereich und ist für den Zugriff durch die entsprechende andere Kennung verfügbar.

Durch Aufrufen der Systemfunktion 'javaLib.remove()' oder 'javaLib.removeAll()' wird es Java Virtual Machine durch Ihren Code ermöglicht, die Funktion 'Garbage-Collection' im EGL-Java-Objektbereich auszuführen. Wenn Sie zum Entfernen eines Objekts aus dem Objektbereich keine Systemfunktion aufrufen, wird der Speicher zur Laufzeit eines Programms mit Zugriff auf den Objektbereich nicht wiederhergestellt.

Weitere Informationen zum EGL-Java-Objektbereich, in dem 'javaLib.remove()' 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.remove(Kennung javaObjId in)
Kennung
Eine von der Groß-/Kleinschreibung abhängige Kennung, die auf ein Objekt 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 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. Wenn die Kennung nicht gefunden wird, tritt kein Fehler auf.

Beispiel

Im folgenden Beispiel wird myStoredObject (als 'objID' umgesetzt) von der Funktion aus dem Objektbereich entfernt.

  javaLib.remove(myStoredObject as "objID:java");

Feedback