Siemens SIMATIC S7 Serie Systemhandbuch Seite 369

Hinweis
Verwendung von GetInstancePath in Funktionsbausteinen mit einer Instanz
Wenn der Funktionsbaustein, in dem Sie GetInstancePath aufrufen, Daten in seinem eigenen
Instanz-Datenbaustein speichert, gibt GetInstancePath den Namen der einzelnen Instanz als
den globalen Namen aus. Das Ergebnis am Parameter OUT entspricht in diesem Fall der
Anweisung GetInstanceName (Seite 364).
9.2.5.5 GetBlockName (Name des Bausteins auslesen)
Tabelle 9-74 Anweisung GetBlockName
KOP/FUP
Parameter
Die folgende Tabelle zeigt die Parameter der Anweisung GetBlockName:
Parameter Deklaration
SIZE Input
RET_VAL Output
Weitere Informationen zu gültigen Datentypen finden Sie unter "Datentypen (Seite 105)".
Beispiel: Bedeutung des Parameters SIZE
Um die Länge des Bausteinnamens auf eine bestimmte Anzahl von Zeichen zu begrenzen,
geben Sie die maximale Länge am Parameter SIZE an. Wenn GetBlockName den Namen
abschneidet, wird dies durch das Zeichen "..." (Unicode-Zeichen 16#2026) am Ende des Namens
deutlich gemacht. Beachten Sie, dass dieses Zeichen die Länge 1 hat.
S7-1200 Automatisierungssystem
Systemhandbuch, V4.5 05/2021, A5E02486681-AO
SCL
RET_VAL := GetBlockName(
size:=_dint_in_);
Datentyp Speicherbereich
UINT E, A, M, D, L oder
Konstante
WSTRING E, A, M, D, L
9.2 Zeichenketten- und Zeichenanweisungen
Beschreibung
Mit der Anweisung GetBlockName lesen Sie den
Name des Bausteins, in dem die Anweisung auf‐
gerufen wird.
Beschreibung
Begrenzt die Anzahl von Zeichen, die am Parameter
RET_VAL ausgegeben werden.
• SIZE > 0: GetBlockName gibt die ersten SIZE Zeichen
des Namens aus.
• SIZE = 0: GetBlockName gibt den vollständigen Na‐
men aus.
• SIZE < 0: GetBlockName gibt die letzten SIZE Zeichen
des Namens aus.
Gelesener Name des Instanz-Datenbausteins
Erweiterte Anweisungen
369