Parámetro
La tabla siguiente muestra los parámetros de la instrucción GetInstanceName:
Parámetro
Declaración
SIZE
Input
OUT
Output
Encontrará información adicional sobre los tipos de datos válidos en "Tipos de datos
(Página 106)".
Ejemplo: Significado del parámetro SIZE
Para limitar la longitud del nombre de instancia leído debe utilizarse el parámetro SIZE. Si la
instrucción ha truncado el nombre, indica el truncamiento en el carácter "..." (carácter Unicode
16#2026) al final del nombre. Tenga en cuenta que este carácter tiene una longitud de 1.
El siguiente ejemplo ilustra el significado del parámetro SIZE. GetInstanceName ha leído el
nombre de instancia siguiente desde la interfaz del bloque: "Level1_DB" (las comillas dobles al
principio y al final forman parte del nombre).
SIZE
1
2
3
Controlador programable S7-1200
Manual de sistema, V4.5 05/2021, A5E02486683-AO
Tipo de da‐
Área de memoria
tos
DINT
I, Q, M, D, L o cons‐
tante
WSTRING
I, Q, M, D, L
Se devuelve GetSymbol‐
Path
'...'
'"...'
'"L...'
Descripción
Limita el número de caracteres emitidos en el parámetro
OUT.
•
SIZE > 0: GetInstanceName devuelve los primeros
caracteres SIZE del nombre.
•
SIZE = 0: GetInstanceName devuelve el nombre com‐
pleto.
•
SIZE < 0: GetInstanceName devuelve los últimos ca‐
racteres SIZE del nombre.
Leer el nombre del bloque de datos de instancia
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:'
•
Primer carácter de WSTRING:'
•
Los dos primeros caracteres del nombre e identificador de
que se ha truncado el nombre:"... "L...
•
Último carácter de WSTRING:'
Instrucciones avanzadas
9.2 Cadena y carácter
363