isNull()

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.

Syntax

  javaLib.isNull(Kennung javaObjID in)
  returns (Ergebnis INT)
Kennung

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.

Ergebnis
Entweder 1 für 'true' (wahr) oder 0 für 'false' (falsch).

Beispiel

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 

Hinweise zu Fehlern

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.

Tabelle 1. Fehlercodes für 'isNull()'
Wert in 'sysVar.errorCode' Beschreibung
00001001 Die angegebene Kennung ist nicht im Objektbereich vorhanden.

Feedback