Informationen Zur Laufzeit; Getsymbolname (Namen Einer Variable Am Eingangsparameter Auslesen) - Siemens Simatic s7 Handbuch

Erweiterte Anweisungen
9.2 Zeichenketten- und Zeichenanweisungen
9.2.5

Informationen zur Laufzeit

9.2.5.1

GetSymbolName (Namen einer Variable am Eingangsparameter auslesen)

Tabelle 9- 70 Anweisung GetSymbolName
KOP/FUP
Parameter
Die folgende Tabelle zeigt die Parameter der Anweisung GetSymbolName:
Parameter Deklaration
VARIABLE Input
SIZE Input
OUT Return
Sie geben die Eingangsparameter der Bausteinschnittstelle am Parameter VARIABLE an.
Verwenden Sie nur einen Schnittstellenparameter für diesen Parameter und keine PLC-
Variable oder Datenbausteinvariable.
Um die Länge des gelesenen Variablennamens zu begrenzen, verwenden Sie den
Parameter SIZE. Wenn die Anweisung den Namen abschneidet, wird dies durch die Zeichen
"..." (Unicode-Zeichen 16#2026) am Ende des Namens deutlich gemacht. Beachten Sie,
dass dieses Zeichen die Länge 1 hat.
Weitere Informationen zu gültigen Datentypen finden Sie unter "Datentypen (Seite 131)".
392
SCL
OUT := GetSymbolName(
variable:=_parameter_in_,
size:=_dint_in_);
Datentyp Speicherbe-
reich
PARAMETER Parameterab-
schnitte Input,
Output, InOut
DINT E, A, M, D, L
WSTRING E, A, M, D, L
Beschreibung
Die Anweisung GetSymbolName gibt eine
Zeichenkette aus, die dem Namen einer Vari-
ablen aus der Bausteinschnittstelle entspricht.
Ihr Programm kann die Anweisung mehrere
Male mit unterschiedlichen Variablen aufrufen.
Der Prozesswert der Variable ist irrelevant.
Die Anweisung gibt den gelesenen Namen am
Parameter OUT aus.
Beschreibung
Variable aus der lokalen Bausteinschnittstelle, de-
ren Name als String-Wert ausgegeben werden soll
Begrenzt die Anzahl von Zeichen, die am Parame-
ter OUT ausgegeben werden:
SIZE > 0: GetSymbolName gibt die ersten SIZE
•
Zeichen des Namens aus.
SIZE = 0: GetSymbolName gibt den vollständi-
•
gen Namen aus.
SIZE < 0: GetSymbolName gibt die letzten SIZE
•
Zeichen des Namens aus.
Ausgabe des vom Eingangsparameter gelieferten
Variablennamens
S7-1200 Automatisierungssystem
Systemhandbuch, V4.2, 09/2016, A5E02486681-AK