ArrayAddValue (Método)

Descripción general

Tipo:	Método
Disponible desde:	1.2.3.0

Descripción funcional

Añade un valor a una ARRAY abierta en la STRING que se está procesando.

El formato del valor añadido a la STRING dependerá del tipo de datos de la variable asignada a la entrada i_anyValue. El valor asignado se convierte, si es necesario, a una ASCII STRING, que se añade en el formato adecuado para la STRING que se está procesando.

A diferencia de los métodos ArrayAdd<data type>, que únicamente admiten un tipo de datos específico para el valor, este método único admite diversos tipos de datos para la entrada i_anyValue.

Se admiten las variables de los tipos de datos BOOL, STRING, INT, UINT, DINT, UDINT, BYTE, WORD, DWORD, LWORD, REAL, LREAL, SINT, USINT, LINT, ULINT, TIME, LTIME, DATE_AND_TIME, DATE y TOD para la entrada i_anyValue.

El valor de retorno es TRUE si la función se ha ejecutado correctamente. Evalúe la propiedad Result en caso de que el valor de retorno sea FALSE.

Si el método no se ejecuta correctamente, podría ser debido a lo siguiente:

Causa posible	Efecto
La STRING actual no contiene una ARRAY abierta.	La STRING no sufrirá cambios.
Se ha alcanzado la longitud máxima de la STRING actual.	La STRING no sufrirá cambios.
No se admite el tipo de datos (por ejemplo, ARRAY o WSTRING) de la variable asignada a i_anyValue.	La STRING no sufrirá cambios.

Interfaz

Entrada	Tipo de datos	Descripción
i_anyValue	ANY*	Especifica el valor que se desea añadir.
*()** Los tipos de datos compatibles son: BOOL, STRING, INT, UINT, DINT, UDINT, BYTE, WORD, DWORD, LWORD, REAL, LREAL, SINT, USINT, LINT, ULINT, TIME, LTIME, DATE_AND_TIME, DATE y TOD.

Ejemplo

Al invocar el método ArrayAddValue, se añade el texto marcado en negrita en el ejemplo a la STRING:

{"Array":[1,2,<value>}

<value> corresponde al valor especificado con la entrada i_anyValue del método.