BYTE-LENGTH - Anzahl Bytes

Die BYTE-LENGTH-Funktion liefert eine ganze Zahl, die die Länge von argument-1 in Bytes darstellt.
Funktionstyp: ganzzahlig.

Format

---

FUNCTION BYTE-LENGTH (argument-1)

---

Argumente

1. argument-1 muss ein alphanumerisches oder nationales Literal sein oder ein Datenelement jeder Klasse oder Kategorie oder ein Typname.

2. Ist irgendein argument-1 untergeordnetes Datenfeld mit der DEPENDING-Angabe der OCCURS-Klausel beschrieben, so wird der Inhalt des DEPENDING-Datenfeldes zum Zeitpunkt der Auswertung der LENGTH-Funktion verwendet.

Returnwerte

1. Wenn argument-1 ein nichtnumerisches Literal, ein Datenelement oder ein Gruppenfeld ist, das kein variabel langes Datenfeld enthält, dann ist der Returnwert die Länge von argument-1 in Bytes.

   Handelt es sich bei argument-1 um eine Objektreferenz, so wird die Länge der Objektreferenz und nicht die Größe des Objektes selbst geliefert.

2. Ist argument-1 ein Gruppenfeld, dem ein variabel langes Datenfeld untergeordnet ist, so ist der Returnwert die Länge von argument-1 in Bytes. Sie berechnet sich entsprechend den Regeln für ein Sendefeld mit OCCURS-Klausel.

3. Der Returnwert zählt vorkommende implizite FILLER-Zeichen in argument-1 mit.

Siehe auch: LENGTH

Beispiel 9-5

...
DATA DIVISION.
WORKING-STORAGE SECTION.
01  RES PIC 9(3).
PROCEDURE DIVISION.
MAIN.
    COMPUTE RES = FUNCTION LENGTH (N"anita beiss sie, bat ina").
    DISPLAY RES UPON T.
    STOP RUN.

Ergebnis: 048