Siemens SIMATIC S7-1200 - 9.2.5.3 GetInstanceName (Read out name of the block instance)

Extended instructions
9.2 String and character
S7-1200 Programmable controller
376 System Manual, V4.2, 09/2016, A5E02486680-AK
9.2.5.3
GetInstanceName (Read out name of the block instance)
Table 9- 72 GetInstanceName instruction
LAD / FBD
SCL
Description
OUT := GetInstanceName(
size:=_dint_in_);
You can use the GetInstanceName instruction
to read the name of the instance data block
within a function block.
Parameter
The following table shows the parameters of the GetInstanceName instruction:
Parameter
Declaration
Data type
Memory area
Description
SIZE Input DINT I, Q, M, D, L or
constant
Limits the number of characters output at the OUT
parameter.
• SIZE > 0: GetInstanceName returns the first SIZE
characters of the name.
• SIZE = 0: GetInstanceName returns the entire
name.
• SIZE < 0: GetInstanceName returns the last SIZE
characters of the name.
OUT
Output
WSTRING
I, Q, M, D, L
Read name of the instance data block
You can find additional information on valid data types under "Data types (Page 125)".