Información De Tiempo De Ejecución; Getsymbolname (Leer Nombre De Una Variable En El Parámetro De Entrada) - Siemens S7 Serie Manual De Sistema

9.2.5 Información de tiempo de ejecución
9.2.5.1 GetSymbolName (leer nombre de una variable en el parámetro de entrada)
Tabla 9- 70 Instrucción GetSymbolName
KOP / FUP
Parámetro
La tabla siguiente muestra los parámetros de la instrucción GetSymbolName:
Parámetro Declaración
VARIABLE Input
SIZE Input
OUT Return
Los parámetros de entrada de la interfaz del bloque se especifican en el parámetro
VARIABLE. Para este parámetro debe utilizarse únicamente un parámetro de interfaz y no
una variable PLC o de bloque de datos.
Para limitar la longitud del nombre de variable leído debe utilizarse el parámetro SIZE. Si la
instrucción trunca el nombre, indica que el truncamiento en los caracteres "..." (carácter
Unicode 16#2026) aparece al final del nombre. Tenga en cuenta que este carácter tiene una
longitud de 1.
Encontrará información adicional sobre los tipos de datos válidos en "Tipos de datos
(Página 136)".
Controlador programable S7-1200
Manual de sistema, V4.2, 09/2016, A5E02486683-AK
SCL
OUT := GetSymbolName(
variable:=_parameter_in_,
size:=_dint_in_);
Tipo de datos Área de me-
moria
PARAMETER Secciones de
parámetro
Input, Output,
InOut
DINT I, Q, M, D, L
WSTRING I, Q, M, D, L
Descripción
La instrucción GetSymbolName devuelve una
cadena correspondiente al nombre de una
variable de la interfaz del bloque.
El programa puede llamar la instrucción varias
veces con diferentes variables. El valor de
proceso de la variable es irrelevante.
La instrucción devuelve el nombre leído en el
parámetro OUT.
Descripción
Variable de la interfaz del bloque local para la que
debe devolverse un valor de cadena del nombre
Limita el número de caracteres emitidos en el pa-
rámetro OUT:
SIZE > 0: GetSymbolName devuelve los prime-
•
ros caracteres SIZE del nombre.
SIZE = 0: GetSymbolName devuelve el nombre
•
completo.
SIZE < 0: GetSymbolName devuelve los últimos
•
caracteres SIZE del nombre.
Salida del nombre de variable suministrado por el
parámetro de entrada
Instrucciones avanzadas
9.2 Cadena y carácter
391