List

Referência > Referência de funções > Funções de agregação > List

List

Propósito

Retorna uma lista concatenada de valores que não estão em branco de um ou mais campos.

Formato

List ( campo {; campo...} )

Parâmetros

campo - qualquer campo relacionado, campo de repetição ou conjunto de campos sem repetição; uma expressão que retorna um campo, campo de repetição ou conjunto de campos sem repetição ou uma variável.

Os parâmetros entre chaves { } são opcionais.

Tipo de dados retornado

texto

Originado em

FileMaker Pro 8.5

Descrição

Os itens listados são separados por quebras de linha.

Use esta função para retornar uma lista de valores para:

•um único campo ( tabela::campo ), que retorna um único resultado em relação a todas as repetições (se houver) desse campo e em relação a todos os registros relacionados correspondentes, se esses registros aparecerem em um portal ou não.

•vários campos e/ou valores literais ( tabela::campo1,constante,tabela::campo2... ), que retorna um resultado separado para cada repetição do cálculo em cada repetição correspondente dos campos. Se todos os campos estiverem relacionados, somente o primeiro registro relacionado será usado.

Exemplos

Nos seguintes exemplos:

•Campo1 contém branco.

•Campo2 contém preto.

•Campo3 contém três repetições com valores de vermelho, verde, azul.

•Relacionado::Campo4 se refere aos três registros que contêm 100, 200, 300.

•$f1 contém laranja.

Nota Ao fazer referência a vários campos de repetição, List ( ) retorna a lista de valores da primeira repetição na primeira repetição do cálculo e depois a lista de valores da segunda repetição na segunda repetição e assim por diante.

Exemplo 1

List ( Campo1 ; Campo2 ) retorna:

•branco

•preto

Exemplo 2

List ( Campo3 ) retorna:

•vermelho

•verde

•azul

Exemplo 3

List ( Campo1 ; Campo2 ; Campo3 ) retorna:

na repetição de cálculo 1;