Ejemplo: Significado Del Parámetro Size - Siemens SIMATIC S7-1200 Manual De Sistema

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 106)".
Ejemplo: Significado del parámetro SIZE
El siguiente ejemplo ilustra el significado del parámetro SIZE. El nombre de variable siguiente se
lee desde la interfaz del bloque: "MyPLCTag" (las comillas dobles al principio y al final forman
parte del nombre).
SIZE
1
2
Controlador programable S7-1200
Manual de sistema, V4.5 05/2021, A5E02486683-AO
Tipo de datos Área de me‐
moria
PARAMETER Secciones de
parámetro In‐
put, Output,
InOut
DINT I, Q, M, D, L
WSTRING I, Q, M, D, L
Se devuelve GetSymbolNa‐
me
'...'
'"...'
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 pará‐
metro OUT:
• SIZE > 0: GetSymbolName devuelve los primeros
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 pa‐
rámetro de entrada
Explicación
• Primer carácter de WSTRING:'
• Identificador de que se ha truncado el nombre: ...
• Último carácter de WSTRING:'
• Primer carácter de WSTRING:'
• Primer carácter del nombre e identificador de que se ha
truncado el nombre:"...
• Último carácter de WSTRING:'
Instrucciones avanzadas
9.2 Cadena y carácter
357