IBM FileNet P8, Version 5.2.1            

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:
Tabela 1. Tabela de Parâmetros e Descrições da Função nextelement
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:
Tabela 2. Parâmetros e Descrições da Função arraytostring
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>")
Exemplo de esquema


Last updated: October 2015
bpfe003.htm

© Copyright IBM Corporation 2015.