Compartilhar via

Listar funções

  • Artigo

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

Informação

Nome Descrição
List.Count Retorna o número de itens em uma lista.
List.IsEmpty Retorna true se a lista estiver vazia.
List.NonNullCount Retorna o número de itens não nulos na lista.

Escolha

Nome Descrição
List.Alternate Retorna uma lista composta por todos os elementos de deslocamento de número ímpar em uma lista.
List.Buffer Armazena uma lista em buffer.
List.Distinct Retorna uma lista de valores com duplicatas removidas.
List.FindText Retorna uma lista de valores (incluindo campos de registro) que contêm o texto especificado.
List.First Retorna o primeiro valor da lista ou o padrão especificado se vazio.
List.FirstN Retorna o primeiro conjunto de itens na lista especificando quantos itens devem ser retornados ou uma condição de qualificação.
List.InsertRange Insere valores em uma lista no índice fornecido.
List.IsDistinct Indica se há duplicatas na lista.
List.Last Retorna o último valor da lista ou o padrão especificado se vazio.
List.LastN Retorna o último valor na lista. Opcionalmente, é possível especificar quantos valores retornar ou uma condição de qualificação.
List.MatchesAll Retorna true se a função de condição for atendida por todos os valores na lista.
List.MatchesAny Retorna true se a função de condição for atendida por qualquer valor.
List.Positions Retorna uma lista de deslocamentos para a entrada.
List.Range Retorna um subconjunto da lista começando em um deslocamento.
List.Select Retorna uma lista de valores que correspondem à condição.
List.Single Retorna o item de uma lista para uma lista de comprimento um, caso contrário, gera uma exceção.
List.SingleOrDefault Retorna o único item de uma lista quando ela possui comprimento um e o valor padrão para uma lista vazia.
List.Skip Retorna uma lista que ignora o número especificado de elementos no início da lista.

Funções de transformação

Nome Descrição
List.Accumulate Acumula um valor de resumo dos itens na lista.
List.Combine Retorna uma única lista combinando várias listas.
List.ConformToPageReader Essa função destina-se apenas ao uso interno.
List.RemoveFirstN Retorna uma lista que ignora o número especificado de elementos no início da lista.
List.RemoveItems Remove itens da primeira lista que estão presentes na segunda lista.
List.RemoveLastN Retorna uma lista que remove o número especificado de elementos do final da lista.
List.RemoveMatchingItems Remove todas as ocorrências dos valores de entrada.
List.RemoveNulls Remove todos os valores null da lista especificada.
List.RemoveRange Remove o número de contagem de valores começando na posição especificada.
List.Repeat Retorna uma lista com count repetições da lista original.
List.ReplaceMatchingItems Substitui ocorrências de valores existentes na lista por novos valores que correspondem à condição.
List.ReplaceRange Substitui count número de valores começando em position pelos valores de substituição.
List.ReplaceValue Pesquisa uma lista pelo valor especificado e o substitui.
List.Reverse Inverte a ordem dos valores na lista.
List.Split Divide a lista especificada em uma lista de listas usando o tamanho da página especificado.
List.Transform Retorna uma nova lista de valores computados nessa lista.
List.TransformMany Retorna uma lista cujos elementos são transformados da lista de entrada usando funções especificadas.
List.Zip Retorna uma lista de listas combinando itens na mesma posição em várias listas.

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 true se todas as expressões forem verdadeiras.
List.AnyTrue Retorna verdadeiro se qualquer expressão for verdadeira.
List.Contains Indica se a lista contém o valor.
List.ContainsAll Indica onde uma lista inclui todos os valores em outra lista.
List.ContainsAny Indica onde uma lista inclui qualquer um dos valores em outra lista.
List.PositionOf Retorna os deslocamentos de um valor em uma lista.
List.PositionOfAny Retorna o primeiro deslocamento de um valor em uma lista.

Definir operações

Nome Descrição
List.Difference Retorna a diferença das duas listas fornecidas.
List.Intersect Retorna a interseção dos valores de lista encontrados na entrada.
List.Union Retorna a união dos valores de lista encontrados na entrada.

Pedido

As funções de ordenação executam comparações. Todos os valores comparados devem ser comparáveis uns com os outros. Isso significa que todos eles devem vir do mesmo tipo de dados (ou incluir nulo, que sempre compara o menor). Caso contrário, um Expression.Error será lançado.

Os tipos de dados comparáveis incluem:

  • Número
  • Duração
  • DateTime
  • Texto
  • Lógico
  • Zero
Nome Descrição
List.Max Retorna o valor máximo ou o valor padrão de uma lista vazia.
List.MaxN Retorna os valores máximos na lista. O número de valores a serem retornados ou uma condição de filtragem deve ser especificado.
List.Median Retorna o valor mediano na lista.
List.Min Retorna o valor mínimo ou o valor padrão de uma lista vazia.
List.MinN Retorna os valores mínimos na lista. O número de valores a serem retornados ou uma condição de filtragem pode ser especificado.
List.Sort Classifica uma lista de dados de acordo com os critérios especificados.
List.Percentile Retorna um ou mais percentis de exemplo correspondentes às probabilidades fornecidas.

Averages

Essas funções operam em listas homogêneas de Números, DateTimes e Durações.

Nome Descrição
List.Average Retorna a média dos valores. Funciona com valores de número, data, datetime, datetimezone e duração.
List.Mode Retorna o valor mais frequente na lista.
List.Modes Retorna uma lista dos valores mais frequentes na lista.
List.StandardDeviation Retorna uma estimativa baseada em exemplo do desvio padrão. Essa função executa uma estimativa baseada em exemplo. O resultado é um número de números e uma duração de DateTimes e Durations.

Adição

Essas funções funcionam em listas homogêneas de Números ou Durações.

Nome Descrição
List.Sum Retorna a soma dos itens na lista.

Numerics

Essas funções funcionam apenas com números.

Nome Descrição
List.Covariance Retorna a covariância entre as duas listas de números.
List.Product Retorna o produto dos números na lista.

Geradores

Essas funções geram uma lista de valores.

Nome Descrição
List.Dates Gera uma lista de valores date dado um valor inicial, uma contagem e um valor de duração incremental.
List.DateTimes Gera uma lista de valores datetime dado um valor inicial, uma contagem e um valor de duração incremental.
List.DateTimeZones Gera uma lista de valores datetimezone dado um valor inicial, uma contagem e um valor de duração incremental.
List.Durations Gera uma lista de valores duration dado um valor inicial, uma contagem e um valor de duração incremental.
List.Generate Gera uma lista de valores.
List.Numbers Retorna uma lista de números com um valor inicial, uma contagem e um valor de incremento opcional.
List.Random Retorna uma lista de números aleatórios.
List.Times Gera uma lista de valores time dado um valor inicial, uma contagem e um valor de duração incremental.

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 dos seguintes:
    • Um seletor de chave que determina o valor na lista para aplicar os critérios de igualdade.
    • Uma função de comparador usada para especificar o tipo de comparação a ser aplicada. 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, vá para 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, vá para 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 chave e uma ordem de controle, o critério de comparação pode ser uma lista que contém a chave e a ordem.
  • Para controlar completamente a comparação, uma função de dois argumentos pode ser usada que retorna -1, 0 ou 1 dada 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, vá para List.Sort.

Operações de substituição

As operações de substituição são especificadas por um valor de lista. Cada item desta lista deve 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.