Siemens SIMATIC S7 Serie Systemhandbuch Seite 365

Parameter
Die folgende Tabelle zeigt die Parameter der Anweisung GetInstanceName:
Parameter Deklaration
SIZE Input
OUT Output
Weitere Informationen zu gültigen Datentypen finden Sie unter "Datentypen (Seite 105)".
Beispiel: Bedeutung des Parameters SIZE
Um die Länge des gelesenen Instanznamens zu begrenzen, verwenden Sie den Parameter SIZE.
Wenn die Anweisung den Namen abgeschnitten hat, 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.
Das folgende Beispiel veranschaulicht die Bedeutung des Parameters SIZE. GetInstanceName
hat den folgenden Instanznamen aus der Bausteinschnittstelle gelesen: "Level1_DB" (die
doppelten Anführungszeichen am Anfang und Ende des Namens gehören zum Namen).
SIZE
1
2
3
S7-1200 Automatisierungssystem
Systemhandbuch, V4.5 05/2021, A5E02486681-AO
Datentyp Speicherbereich
DINT E, A, M, D, L oder
Konstante
WSTRING E, A, M, D, L
Ausgabe von GetSymbol‐
Path
'...'
'"...'
'"L...'
9.2 Zeichenketten- und Zeichenanweisungen
Beschreibung
Begrenzt die Anzahl von Zeichen, die am Parameter OUT
ausgegeben werden.
• SIZE > 0: GetInstanceName gibt die ersten SIZE Zei‐
chen des Namens aus.
• SIZE = 0: GetInstanceName gibt den vollständigen
Namen aus.
• SIZE < 0: GetInstanceName gibt die letzten SIZE Zei‐
chen des Namens aus.
Gelesener Name des Instanz-Datenbausteins
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:'
• Erstes Zeichen von WSTRING:'
• Die ersten beiden Zeichen des Namens und Kennzeichen
dafür, dass der Name abgeschnitten wurde:"... "L...
• Letztes Zeichen von WSTRING:'
Erweiterte Anweisungen
365