Funciones de matriz
Esta sección contiene breves descripciones de las funciones que devuelven información sobre una matriz especificada.
Función | Qué hace |
---|---|
arraytostring | A partir de los datos de la matriz, el patrón de inicio, el patrón de fin y el separador, devuelve una serie. |
elementcount | Devuelve el número de elementos no nulos o no vacíos de una matriz. |
nextelement | A partir de un campo de una matriz y de un índice de esa matriz, devuelve la siguiente entrada no vacía y no nula, o cero si no hay ninguna disponible. |
elementcount
Devuelve el número (entero) de elementos no nulos o no vacíos en la matriz. Tenga en cuenta que sizeof (<array_field>) devuelve el tamaño actual de la matriz, pero algunos elementos pueden ser entradas vacías o nulas en la matriz. Para matrices adjuntas, el archivo adjunto vacío se considera vacío.
elementcount(array_field)
donde array_field es el campo de datos que contiene los datos de origen.Los siguientes son algunos ejemplos:
A = ("", , "", "alpha", ,"") => elementcount(A) = 1; sizeof (A) = 6
B = (0 , , 0 , 100 , , 0) => elementcount(B) = 4; sizeof (B) = 6
Tenga en cuenta que en las matrices de serie no se cuenta una serie vacía, pero en las matrices numéricas se cuentan todos los números. En otras palabras, no hay números vacíos.
Esta función es útil para manejar matrices de participantes y archivos adjuntos.
nextelement
A partir de un campo de matriz y de un índice de la matriz, esta función devuelve la siguiente entrada no vacía y no nula, o cero si no hay ninguna entrada disponible. Si la expresión entera es cero, devuelve el primer elemento no vacío y no nulo.
nextelement(array_field, index_expr)
donde:Parámetro | Descripción |
---|---|
array_field | El campo de datos que contiene los datos de origen. |
index_expr | El índice que se debería utilizar para iniciar la búsqueda. Si es cero, iniciará la búsqueda desde el principio de la matriz. |
Por ejemplo, utilizando los matrices
A = ("", , "", "alpha",,"") B =(0 , , 0 , 100 , , 0)
nextelement (A, 0) = 4
nextelement (A, 4) = 0
nextelement (B, 0) = 1
nextelement (B, 1) = 3
nextelement (B, 3) = 4
nextelement (B, 4) = 6
nextelement (B, 6) = 0
Nota: Los índices de matriz de proceso
empiezan en uno, pero el índice cero se utiliza para buscar el primer elemento
no vacío y no nulo.
Esta función es útil para manejar matrices de participantes y archivos adjuntos.
arraytostring
Esta función convierte datos de matriz en una serie.
arraytostring(array_field, begin_expr, end_expr, separator_expr)
donde:Parámetro | Descripción |
---|---|
array_field | El campo de datos que contiene los datos de origen. |
begin_expr | La serie de texto que marca el principio de la matriz. |
end_expr | La serie de texto que marca el final de la matriz. |
separator_expr | La serie de texto que se utiliza para separar los elementos en la matriz. |
Por ejemplo, a partir del campo de datos MyStringArray con
contenido {1,2,3}, se usaría el siguiente mandato
para devolver datos de serie:
- arraytostring(MyStringArray, "{ ", " }", ",") devuelve { 1,2,3 }
Esta función se puede utilizar para devolver una serie a partir
de una matriz de campos de datos en un esquema XML de MyXMLField.
arraytostring(MyXMLField, ("<tag><value>", "</value></tag>", "</value><value>")
