VARIABLE-TO-STRING( ) Variable konvertieren

Anwendungsgebiet: Konvertierungsfunktionen

Die Funktion VARIABLE-TO-STRING( ) konvertiert eine S-Variable vom Typ Struktur in einen String (siehe dazu Abschnitt „SDF-Kommando-Strings zu S-Variablen konvertierenund umgekehrt“ (SDF-Kommando-Strings zu S-Variablen konvertieren und umgekehrt )).

Format

VARIABLE-TO-STRING( )

VAR-TO-STR( )

VARIABLE-NAME = string_ausdruck

Ergebnistyp

STRING

Eingabeparameter

VARIABLE-NAME = string_ausdruck
Name der S-Variablen vom Typ Struktur, die in einen String konvertiert werden soll. Der Variablenname muss in Hochkommata eingeschlossen werden, wenn man ihn direkt (als Literal) angeben will (siehe folgendes Beispiel sowie das Beispiel bei IS-DECLARED( ), "IS-DECLARED( ) Variablendeklaration prüfen ").

Ergebnis

Konvertierter Ausdruck als String

Fehlermeldung

SDP0475   VARIABLE MUSS STRUKTUR, LISTE ODER ARRAY SEIN
SDP0476   ERGEBNIS-STRING ZU LANG 
SDP0477   FEHLERHAFTE SDF-STRUKTUR 
SDP1007   NOCH KEINE VARIABLE ANGELEGT

Beispiel

/DECLARE-VARIABLE MYSTRUCT(TYPE=*STRUCTURE(DEF=*DYNAMIC))
/MYSTRUCT.OPERAND1.SYSSTRUC = 'VALUE1'
/MYSTRUCT.OPERAND1.OPERAND2 = 'VALUE2'
/MYSTRUCT.OPERAND1.OPERAND3#1 = 'VALUE3'
/WRITE-TEXT &(TO-C-LITERAL(VARIABLE-TO-STRING('MYSTRUCT'))) 
OPERAND1 = VALUE1(OPERAND2 =VALUE2, OPERAND3 = (VALUE3))