Nota
Uso de GetInstancePath en bloques de función con instancia individual
Si el bloque de función en el que se llama GetInstancePath guarda datos en su propio bloque de
datos de instancia, GetInstancePath emite el nombre de la instancia individual como nombre
global. El resultado en el parámetro OUT se corresponde en este caso con la
instrucción GetInstanceName (Página 362).
9.2.5.5
GetBlockName (leer el nombre del bloque)
Tabla 9-74
Instrucción GetBlockName
KOP / FUP
Parámetro
La tabla siguiente muestra los parámetros de la instrucción GetBlockName:
Parámetro
Declaración
SIZE
Input
RET_VAL
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 del bloque en un determinado número de caracteres,
especifique la longitud máxima en el parámetro SIZE. Si GetBlockName trunca 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.
Controlador programable S7-1200
Manual de sistema, V4.5 05/2021, A5E02486683-AO
SCL
RET_VAL := GetBlockName(
size:=_dint_in_);
Tipo de da‐
Área de memoria Descripción
tos
UINT
I, Q, M, D, L o cons‐
tante
WSTRING
I, Q, M, D, L
Descripción
La instrucción GetBlockName se utiliza para leer
el nombre del bloque en el que se llama la ins‐
trucción.
Limita el número de caracteres emitidos en el parámetro
RET_VAL.
•
SIZE > 0: GetBlockName devuelve los primeros carac‐
teres SIZE del nombre.
•
SIZE = 0: GetBlockName devuelve el nombre comple‐
to.
•
SIZE < 0: GetBlockName devuelve los últimos carac‐
teres SIZE del nombre.
Leer el nombre del bloque de datos de instancia
Instrucciones avanzadas
9.2 Cadena y carácter
367