Die Systemfunktion 'javaLib.isNull()' gibt einen Wert zurück (1 für 'true' (wahr), 0 für 'false' (falsch)), um anzuzeigen, ob eine angegebene Kennung im EGL-Java™-Objektbereich auf ein Nullobjekt verweist.
Weitere Informationen zum EGL-Java-Objektbereich, in dem 'javaLib.isNull()' 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.
javaLib.isNull(Kennung javaObjID in)
returns (Ergebnis INT)
Eine Kennung, die auf ein Objekt im Objektbereich 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'). Die Kennung muss in 'objID' umgesetzt werden. EGL schneidet Einzel- und Doppelbyteleerzeichen am Anfang und Ende des Argumentwertes ab. Bei der Angabe des Wertes muss die Groß-/Kleinschreibung beachtet werden.
Im folgenden Beispiel wird ein Objekt getestet, um zu ermitteln, ob es leer (null) ist. Dies erfolgt anhand der Umsetzung des Objekts als 'objID':
nullFlag = javaLib.isNull(valueId as "objID:java");
if( nullFlag == 1 )
error = 12;
end
Ist die Programmeigenschaft 'v60ExceptionCompatibility' nicht oder auf NO gesetzt, führt eine Ausnahmebedingung dazu, dass EGL eine Ausnahmebedingung vom Typ 'JavaObjectException' auslöst. Andere Fehler führen dazu, dass EGL eine Ausnahmebedingung vom Typ 'RuntimeException' auslöst.
Ist die Programmeigenschaft 'v60ExceptionCompatibility' auf YES gesetzt, kann ein Fehler während der Verarbeitung von 'javaLib.isNull()' dazu führen, dass 'sysVar.errorCode' auf einen in der nächsten Tabelle aufgeführten Wert gesetzt wird.
| Wert in 'sysVar.errorCode' | Beschreibung |
|---|---|
| 00001001 | Die angegebene Kennung ist nicht im Objektbereich vorhanden. |