Siemens SIMATIC S7 Serie Systemhandbuch Seite 359

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 105)".
Beispiel: Bedeutung des Parameters SIZE
Das folgende Beispiel veranschaulicht die Bedeutung des Parameters SIZE. Der folgende
Variablenname wird aus der Bausteinschnittstelle gelesen: "MyPLCTag" (die doppelten
Anführungszeichen am Anfang und Ende des Namens gehören zum Namen).
SIZE
1
2
S7-1200 Automatisierungssystem
Systemhandbuch, V4.5 05/2021, A5E02486681-AO
Datentyp Speicherbe‐
reich
PARAMETER Parameterab‐
schnitte Input,
Output, InOut
DINT E, A, M, D, L
WSTRING E, A, M, D, L
Ausgabe von GetSymbol‐
Name
'...'
'"...'
9.2 Zeichenketten- und Zeichenanweisungen
Beschreibung
Variable aus der lokalen Bausteinschnittstelle, deren
Name als String-Wert ausgegeben werden soll
Begrenzt die Anzahl von Zeichen, die am Parameter
OUT ausgegeben werden:
• SIZE > 0: GetSymbolName gibt die ersten SIZE Zei‐
chen des Namens aus.
• SIZE = 0: GetSymbolName gibt den vollständigen
Namen aus.
• SIZE < 0: GetSymbolName gibt die letzten SIZE
Zeichen des Namens aus.
Ausgabe des vom Eingangsparameter gelieferten Va‐
riablennamens
Bedeutung
• Erstes Zeichen von WSTRING:'
• Kennzeichen dafür, dass der Name abgeschnitten wur‐
de: ...
• Letztes Zeichen von WSTRING:'
• Erstes Zeichen von WSTRING:'
• Das erste Zeichen des Namens und Kennzeichen dafür,
dass der Name abgeschnitten wurde:"...
• Letztes Zeichen von WSTRING:'
Erweiterte Anweisungen
359