Funções de lista

Essas funções criam e manipulam valores de lista.

Informações

Nome	Descrição
List.Count	Retorna o número de itens em uma lista.
List.NonNullCount	Retorna o número de itens em uma lista excluindo valores nulos
List.IsEmpty	Retorna uma mensagem informando se uma lista está vazia.

Seleção

Nome	Descrição
List.Alternate	Retorna uma lista com os itens alternados da lista original baseado em uma contagem, repeatInterval opcional e um deslocamento opcional.
List.Buffer	Armazena em buffer a lista na memória. O resultado dessa chamada é uma lista estável, o que significa que ela terá uma ordem dos itens e uma contagem determinísticas.
List.Distinct	Filtra uma lista removendo duplicatas. Um valor de critérios de equação opcional pode ser especificado para controlar a comparação de igualdade. O primeiro valor de cada grupo de igualdade é escolhido.
List.FindText	Pesquisa uma lista de valores, incluindo campos de registro, para um valor de texto.
List.First	Retorna o primeiro valor da lista ou o padrão especificado se ela está vazia. Retorna o primeiro item da lista ou o valor padrão opcional se a lista está vazia. Se a lista estiver vazia e um valor padrão não for especificado, a função retornará.
List.FirstN	Retorna o primeiro conjunto de itens da lista especificando quantos itens devem ser retornados ou uma condição de qualificação fornecida por countOrCondition.
List.InsertRange	Insere itens de valores no índice fornecido na lista de entrada.
List.IsDistinct	Retorna uma mensagem informando se uma lista é distinta.
List.Last	Retorna o último conjunto de itens da lista especificando quantos itens devem ser retornados ou uma condição de qualificação fornecida por countOrCondition.
List.LastN	Retorna o último conjunto de itens de uma lista especificando quantos itens devem ser retornados ou uma condição de qualificação.
List.MatchesAll	Retorna verdadeiro se todos os itens de uma lista atendem a uma condição.
List.MatchesAny	Retorna verdadeiro se qualquer item de uma lista atende a uma condição.
List.Positions	Retorna uma lista de posições de uma lista de entrada.
List.Range	Retorna uma contagem de itens começando em um deslocamento.
List.Select	Seleciona os itens que correspondem a uma condição.
List.Single	Retorna o único item da lista ou gera um Expression.Error se a lista tem mais de um item.
List.SingleOrDefault	Retorna um único item de uma lista.
List.Skip	Ignora o primeiro item da lista. Considerando uma lista vazia, ele retorna uma lista vazia. Essa função usa um parâmetro opcional countOrCondition para ser compatível com ignorar vários valores.

Funções de transformação

Nome	Descrição
List.Accumulate	Acumula um resultado da lista. Começando na semente de valor inicial, essa função aplica a função de acumulador e retorna o resultado final.
List.Combine	Mescla uma lista de listas em uma só lista.
List.ConformToPageReader	Esta função destina-se somente a uso interno.
List.RemoveRange	Retorna uma lista que remove itens de contagem começando no deslocamento. A contagem padrão é 1.
List.RemoveFirstN	Retorna uma lista com o número especificado de elementos removidos da lista, começando no primeiro elemento. O número de elementos removidos depende do parâmetro opcional countOrCondition.
List.RemoveItems	Remove itens de list1 que estão presentes em list2 e retorna uma nova lista.
List.RemoveLastN	Retorna uma lista com o número especificado de elementos removidos da lista, começando no último elemento. O número de elementos removidos depende do parâmetro opcional countOrCondition.
List.Repeat	Retorna uma lista que repete o conteúdo do número de contagens de uma lista de entrada.
List.ReplaceRange	Retorna uma lista que substitui valores de contagem em uma lista por uma lista replaceWith que começa em um índice.
List.RemoveMatchingItems	Remove todas as ocorrências dos valores especificados na lista.
List.RemoveNulls	Remove os valores nulos de uma lista.
List.ReplaceMatchingItems	Substitui as ocorrências de valores existentes na lista por novos valores usando o equationCriteria fornecido. Os valores novos e antigos são fornecidos pelos parâmetros replacements. Um valor de critérios de equação opcional pode ser especificado para controlar comparações de igualdade. Para obter detalhes sobre operações de substituição e critérios de equação, acesse Valores de parâmetros.
List.ReplaceValue	Pesquisa o valor em uma lista de valores e substitui cada ocorrência pelo valor de substituição.
List.Reverse	Retorna uma lista que reverte os itens em uma lista.
List.Split	Divide a lista especificada em uma lista de listas usando o tamanho da página especificado.
List.Transform	Executa a função em cada item da lista e retorna a nova lista.
List.TransformMany	Retorna uma lista cujos elementos são projetados com base na lista de entrada.

Funções de associação

Como todos os valores podem ser testados quanto à igualdade, essas funções podem operar em listas heterogêneas.

Nome	Descrição
List.AllTrue	Retorna verdadeiro se todas as expressões de uma lista são verdadeiras
List.AnyTrue	Retorna verdadeiro se qualquer expressão de uma lista é verdadeira
List.Contains	Retorna verdadeiro se um valor é encontrado em uma lista.
List.ContainsAll	Retorna verdadeiro se todos os itens nos valores são encontrados em uma lista.
List.ContainsAny	Retorna verdadeiro se qualquer item nos valores é encontrado em uma lista.
List.PositionOf	Encontra a primeira ocorrência de um valor em uma lista e retorna a posição dela.
List.PositionOfAny	Encontra a primeira ocorrência de qualquer valor nos valores e retorna a posição dela.

Set operations

Nome	Descrição
List.Difference	Retorna os itens da lista 1 que não aparecem na lista 2. Há suporte para valores duplicados.
List.Intersect	Retorna uma lista de uma lista de listas e intersecciona itens comuns em listas individuais. Há suporte para valores duplicados.
List.Union	Retorna uma lista de uma lista de listas e une os itens nas listas individuais. A lista retornada contém todos os itens em listas de entrada. É feita a correspondência dos valores duplicados como parte da união.
List.Zip	Retorna uma lista de listas combinando itens na mesma posição.

Ordenando

As funções de ordenação fazem comparações. Todos os valores comparados precisam ser comparáveis entre si. Isso significa que todos eles precisam ser provenientes do mesmo tipo de dados (ou incluir nulo, que sempre compara o menor). Caso contrário, um Expression.Error será gerado.

Os tipos de dados comparáveis incluem:

• Número
• Duração
• Datetime
• Texto
• Lógico
• Nulo

Nome	Descrição
List.Max	Retorna o item máximo em uma lista ou o valor padrão opcional se a lista está vazia.
List.MaxN	Retorna os valores máximos na lista. O número de valores que devem ser retornados ou uma condição de filtragem que deve ser especificada.
List.Median	Retorna o item mediano de uma lista.
List.Min	Retorna o item mínimo em uma lista ou o valor padrão opcional se a lista está vazia.
List.MinN	Retorna os valores mínimos em uma lista. O número de valores que devem ser retornados ou uma condição de filtragem que pode ser especificada.
List.Sort	Retorna uma lista classificada usando o critério de comparação.
List.Percentile	Retorna um ou mais percentis de exemplo correspondentes às probabilidades fornecidas.

Averages

Essas funções operam em listas homogêneas de Numbers, DateTimes e Durations.

Nome	Descrição
List.Average	Retorna um valor médio de uma lista no tipo de dados dos valores na lista.
List.Mode	Retorna um item que aparece mais comumente em uma lista.
List.Modes	Retorna todos os itens que aparecem com a mesma frequência máxima.
List.StandardDeviation	Retorna o desvio padrão de uma lista de valores. List.StandardDeviation faz uma estimativa baseada em amostra. O resultado é um número de números e uma duração de DateTimes e Durations.

Adição

Essas funções operam em listas homogêneas de Numbers ou Durations.

Nome	Descrição
List.Sum	Retorna a soma de uma lista.

Numerics

Essas funções só operam em números.

Nome	Descrição
List.Covariance	Retorna a covariância de duas listas como um número.
List.Product	Retorna o produto de uma lista de números.

Geradores

Essas funções geram uma lista de valores.

Nome	Descrição
List.Dates	Retorna uma lista de valores de data da contagem de tamanho, começando no início, e adiciona um incremento a cada valor.
List.DateTimes	Retorna uma lista de valores de datetime da contagem de tamanho, começando no início, e adiciona um incremento a cada valor.
List.DateTimeZones	Retorna uma lista de valores de datetimezone da contagem de tamanho, começando no início, e adiciona um incremento a cada valor.
List.Durations	Retorna uma lista de valores de durações da contagem de tamanho, começando no início, e adiciona um incremento a cada valor.
List.Generate	Gera uma lista de valores.
List.Numbers	Retorna uma lista de números da contagem de tamanho, começando no início, e adiciona um incremento. O incremento usa 1 como padrão.
List.Random	Retorna uma lista de números aleatórios de contagem, com um parâmetro de semente opcional.
List.Times	Retorna uma lista de valores de tempo da contagem de tamanho, começando no início.

Valores de parâmetro

Especificação de ocorrência

• Occurrence.First = 0;
• Occurrence.Last = 1;
• Occurrence.All = 2;

Ordem de classificação

• Order.Ascending = 0;
• Order.Descending = 1;

Critérios de equação

Os critérios de equação para valores de lista podem ser especificados como:

• Um valor de função que é:
  • Um seletor de chave que determina o valor na lista para aplicar os critérios de igualdade.
  • Uma função de comparador que é usada para especificar o tipo de comparação a ser aplicado. As funções de comparador internas podem ser especificadas; acesse Funções de comparador.
• Um valor de lista que tem:
  • Exatamente dois itens.
  • O primeiro elemento é o seletor de chave, conforme especificado acima.
  • O segundo elemento é um comparador, conforme especificado acima.

Para obter mais informações e exemplos, acesse List.Distinct.

Critérios de comparação

O critério de comparação pode ser fornecido como um dos seguintes valores:

• Um valor numérico para especificar uma ordem de classificação. Para obter mais informações, acesse Ordem de classificação.
• Para calcular uma chave a ser usada para classificação, uma função de um argumento pode ser usada.
• Para selecionar uma ordem de chave e de controle, o critério de comparação pode ser uma lista que contém a chave e a ordem.
• Para controlar por completo a comparação, é possível usar uma função de dois argumentos que retorna -1, 0 ou 1 considerando a relação entre as entradas à esquerda e à direita. Value.Compare é um método que pode ser usado para delegar essa lógica.

Para obter mais informações e exemplos, acesse List.Sort.

Operações de substituição

As operações de substituição são especificadas por um valor de lista. Cada item dessa lista precisa ser:

• Um valor de lista com exatamente dois itens.
• O primeiro item é o valor antigo na lista, a ser substituído.
• O segundo item é o novo valor, que deve substituir todas as ocorrências do valor antigo na lista.