Funções de Matriz
Esta seção contém breves descrições das funções que retornam informações sobre uma matriz especificada.
Função | O que ela faz |
---|---|
arraytostring | Determinados os dados de matriz, o padrão de início, o padrão de fim e o separador, retorna uma cadeia. |
elementcount | Retorna o número de elementos não nulos ou não vazios de uma matriz. |
nextelement | Determinado um campo de matriz e um índice na matriz, retorna a próxima entrada não vazia e não nula, ou zero, se nenhuma estiver disponível. |
elementcount
Retorna o número
(inteiro) de elementos não nulos ou não vazios na matriz. Observe
que sizeof (<array_field>) retorna o tamanho atual da matriz,
mas alguns dos elementos podem ser entradas vazias ou nulas na
matriz. Para matrizes anexas, o anexo vazio é considerado vazio.
elementcount(array_field)
em que array_field é o campo de
dados que contém os dados de origem.Alguns exemplos são:
A = ("", , "", "alpha", ,"") => elementcount(A) = 1; sizeof (A) = 6
B = (0 , , 0 , 100 , , 0) => elementcount(B) = 4; sizeof (B) = 6
Observe que a cadeia vazia não é contada nas matrizes de cadeia, mas cada número é contado em matrizes numéricas. Em outras palavras, não há números vazios.
Esta função é útil para manipular matrizes participantes e anexas.
nextelement
Determinado um
campo de matriz e um índice na matriz, esta função retorna a próxima
entrada não vazia e não nula, ou zero se nenhuma estiver disponível. Se a expressão de números inteiros for zero, ela retornará o primeiro
elemento não vazio e não nulo.
nextelement(array_field,
index_expr)
em que:Parâmetro | Descrição |
---|---|
array_field | O campo de dados que contém os dados de origem. |
index_expr | O índice que deve ser utilizado para iniciar a procura. Se ele for zero, então ele começará a procura a partir do início da matriz. |
Por exemplo, utilizando as matrizes
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: Os índices da matriz do processo iniciam em um, mas o índice zero é usado para procurar o primeiro elemento não vazio, não nulo.
Esta função é útil para manipular matrizes participantes e anexas.
arraytostring
Esta
função converte dados de matriz em uma cadeia.
arraytostring(array_field, begin_expr, end_expr, separator_expr)
em que:Parâmetro | Descrição |
---|---|
array_field | O campo de dados que contém os dados de origem. |
begin_expr | A cadeia de texto que marca o início da matriz. |
end_expr | A cadeia de texto que marca o final da matriz. |
separator_expr | A sequência de texto que é usada para separar os elementos da matriz. |
Por exemplo, determinado o campo de dados MyStringArray com conteúdo {1,2,3}, você usaria o seguinte comando para retornar os dados da sequência:
- arraytostring(MyStringArray, "{ ", " }", ",") retorna { 1,2,3 }
Essa função pode ser usada para retornar uma sequência de uma matriz de campos de dados em um esquema XML no MyXMLField.
arraytostring(MyXMLField,
("<tag><value>", "</value></tag>",
"</value><value>")
