Partilhar via

Listar funções

  • Artigo

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

Informação

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

Seleção

Nome Descrição
List.Alternate Retorna uma lista composta por todos os elementos em posições de índice ímpares numa 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 estiver vazio.
List.FirstN Retorna o primeiro conjunto de itens da lista especificando quantos itens retornar 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 Devolve o último valor da lista. Opcionalmente, pode especificar quantos valores retornar ou uma condição de qualificação.
List.MatchesAll Retorna true se a função de condição for satisfeita por todos os valores na lista.
List.MatchesAny Retorna true se a função de condição for satisfeita por qualquer valor.
List.Positions Devolve uma lista de deslocamentos para a entrada.
List.Range Retorna um subconjunto da lista a partir de uma posição.
List.Select Retorna uma lista de valores que correspondem à condição.
List.Single Retorna o único item de uma lista com comprimento um; se não, lança uma exceção.
List.SingleOrDefault Retorna o único item de lista para uma lista de 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 síntese dos itens na lista.
List.Combine Retorna uma única lista combinando várias listas.
List.ConformToPageReader Esta função destina-se apenas a 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 que começam na posição especificada.
List.Repeat Retorna uma lista que é repetida count vezes 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 a partir de position pelos valores de substituição.
List.ReplaceValue Pesquisa uma lista para o valor especificado e substitui-o.
List.Reverse Inverte a ordem dos valores na lista.
List.Split Divide a lista especificada em uma lista de listas usando o tamanho de página especificado.
List.Transform Devolve uma nova lista de valores calculados a partir desta 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 o(s) deslocamento(s) de um valor em uma lista.
List.PositionOfAny Devolve o primeiro deslocamento de um valor numa lista.

Definir operações

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

Pedido

As funções de ordenação realizam comparações. Todos os valores que são comparados devem ser comparáveis entre si. Isso significa que todos eles devem ser do mesmo tipo de dados (ou incluir nulo, que sempre é considerado o menor). Caso contrário, uma Expression.Error é lançada.

Os tipos de dados comparáveis incluem:

  • Número
  • Duração
  • Data/Hora
  • Texto
  • Lógica
  • Nulo
Nome Descrição
List.Max Retorna o valor máximo ou o valor padrão para uma lista vazia.
List.MaxN Devolve o(s) valor(es) máximo(s) na lista. O número de valores a retornar ou uma condição de filtragem deve ser especificado.
List.Median Devolve o valor mediano na lista.
List.Min Retorna o valor mínimo ou o valor padrão para uma lista vazia.
List.MinN Devolve o(s) valor(es) mínimo(s) na lista. O número de valores a retornar 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 Devolve um ou mais percentis de amostra correspondentes às probabilidades dadas.

Médias

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

Nome Descrição
List.Average Devolve a média dos valores. Funciona com valores de número, data, datetime, datetimezone e duração.
List.Mode Devolve o valor mais frequente na lista.
List.Modes Retorna uma lista dos valores mais freqüentes na lista.
List.StandardDeviation Devolve uma estimativa do desvio padrão baseada numa amostra. Esta função executa uma estimativa baseada em amostras. O resultado é um número para valores numéricos e uma duração para data/hora e durações.

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.

Números

Estas funções só funcionam sobre números.

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

Geradores

Estas funções geram uma lista de valores.

Nome Descrição
List.Dates Gera uma lista de valores de date a partir de um valor inicial, uma quantidade e um valor de duração incremental.
List.DateTimes Gera uma lista de valores de datetime, dado um valor inicial, uma contagem e um valor incremental de duração.
List.DateTimeZones Gera uma lista de valores de datetimezone dados um valor inicial, contagem e valor de duração incremental.
List.Durations Gera uma lista de valores de duration a partir de um valor inicial, um número de 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, contagem e valor de incremento opcional.
List.Random Devolve uma lista de números aleatórios.
List.Times Gera uma lista de valores time dados um valor inicial, uma contagem e um valor incremental de duração.

Valores dos parâmetros

Especificação da 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 é uma das seguintes opções:
    • Um seletor de chave que determina o valor na lista para aplicar os critérios de igualdade.
    • Uma função de comparação que é usada para especificar o tipo de comparação a ser aplicada. As funções de comparação incorporadas podem ser especificadas — vá para funções do 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, clique em 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 contendo 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 elemento desta lista deve ser:

  • Uma lista composta por 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.