IS-INTEGER( ) Ausdruck prüfen

Anwendungsgebiet: Variablenzugriff / Prüffunktionen

Die Funktion IS-INTEGER( ) prüft, ob der als String angegebene Ausdruck einen Integer-Wert darstellt:

• Der String darf nur aus den Ziffern 0 bis 9 bestehen sowie aus den Vorzeichen + und -.

• Das Vorzeichen + oder - muss direkt vor der Zahl stehen, das heißt, Vorzeichen und zugehörige Zahl dürfen nicht durch Leerzeichen getrennt werden.

• Der Wert der Zahl muss im gültigen Wertebereich von -2³¹ bis 2³¹-1 liegen.

Leerzeichen sind am Anfang und am Ende des Strings erlaubt, das heißt, der String darf links- und rechtsbündig mit Leerzeichen aufgefüllt sein. Wenn der geprüfte String einen Integer-Wert enthält, kann er z.B. anschließend mit der Funktion INTEGER( ) konvertiert werden.

Format

IS-INTEGER( )

STRING = string_ausdruck

Ergebnistyp

BOOLEAN

Eingabeparameter

STRING = string_ausdruck
Bezeichnet den String, der auf Integer-Inhalt überprüft wird.

Ergebnis

TRUE
Der String enthält einen Integer-Wert, das heißt, er kann in einen Integer-Wert konvertiert werden.

FALSE
Der String enthält keinen Integer-Wert.

Beispiel

/A = IS-INTEGER (STRING = '   -123')
/SHOW-VARIABLE A
A = TRUE 
/B = IS-INTEGER(STRING = '+(123-3)')
/SHOW-VARIABLE B
B = FALSE 

Im ersten Fall beinhaltet der String einen Integer-Wert. Die enthaltenen Leerzeichen sind erlaubt. Darum ist das Ergebnis: A = TRUE. Im zweiten Fall beinhaltet der String keinen In-teger-Wert, sondern einen Ausdruck. Darum ist das Ergebnis: B = FALSE.