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 
Cada valor retornado, exceto o último, termina com um retorno de carro.
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.
Notas 
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.
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.
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;
branco
preto
vermelho
na repetição de cálculo 2;
verde
na repetição de cálculo 3;
azul
Exemplo 4 
List(Relacionado::Campo4) retorna:
100
200
300
Exemplo 5
List($f1; Campo2) retorna:
laranja
preto
Tópicos relacionados 
Referência de funções (lista de categorias)
Referência de funções (lista em ordem alfabética)
Sobre fórmulas
Sobre funções
Definição de campos de cálculo
Utilização de operadores em fórmulas