Ler em inglês

Compartilhar via


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

Ordem de classificação

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.