Siemens SIMATIC S7 Serie Systemhandbuch Seite 367

9.2.5.4 GetInstancePath (Zusammengesetzten globalen Namen der Baustein-Instanz
abfragen)
Tabelle 9-73 Anweisung GetInstancePath
KOP/FUP
Parameter
Die folgende Tabelle zeigt die Parameter der Anweisung GetInstancePath:
Parameter Deklaration
SIZE Input
OUT Output
Weitere Informationen zu gültigen Datentypen finden Sie unter "Datentypen (Seite 105)".
Beispiel: Aufrufen von GetInstancePath, um den Pfad des Aufrufs eines FB mit mehreren Instanzen
abzufragen
Im folgenden Beispiel ruft der Funktionsbaustein FB_Level_3 die Anweisung GetInstancePath
auf.
• Der Funktionsbaustein FB_Level_3 speichert seine Daten in dem aufrufenden
Funktionsbaustein FB_Level_2.
• Der Funktionsbaustein FB_Level_2 wiederum speichert seine Daten in dem aufrufenden
Funktionsbaustein FB_Level_1.
• Der Funktionsbaustein FB_Level_1 wiederum speichert seine Daten in seinem Instanz-
Datenbaustein IDB_LEVEL_1. Durch die Verwendung mehrerer Instanzen enthält der Instanz-
Datenbaustein von FB_Level_1 alle Daten der drei Funktionsbausteine.
S7-1200 Automatisierungssystem
Systemhandbuch, V4.5 05/2021, A5E02486681-AO
SCL
OUT := GetInstancePath(
size:=_dint_in_);
Datentyp Speicherbereich
DINT E, A, M, D, L oder Kon‐
stante
WSTRING E, A, M, D, L
Erweiterte Anweisungen
9.2 Zeichenketten- und Zeichenanweisungen
Beschreibung
Mit der Anweisung GetInstancePath lesen Sie
den zusammengesetzten globalen Namen der
Bausteininstanz in einem Funktionsbaustein.
Der zusammengesetzte globale Name der Baus‐
teininstanz ist der Pfad der vollständigen Aufruf‐
hierarchie, wenn das Programm mehrere Instan‐
zen aufruft.
Beschreibung
Begrenzt die Anzahl von Zeichen, die am Para‐
meter OUT ausgegeben werden.
• SIZE > 0: GetInstancePath gibt die ersten
SIZE Zeichen des Namens aus.
• SIZE = 0: GeInstancePath gibt den vollstän‐
digen Namen aus.
• SIZE < 0: GetInstancePath gibt die letzten
SIZE Zeichen des Namens aus.
Ausgelesener globaler Namen der Baustein-In‐
stanz.
Wenn der globale Name der Bausteininstanz
länger als die maximale Länge von WSTRING
(254 Zeichen) ist, schneidet GetInstancePath
den Namen ab.
367