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.NonNullCount Devolve o número de itens numa lista excluindo valores nulos
List.IsEmpty Retorna se uma lista está vazia.

Seleção

Nome Descrição
List.Alternate Retorna uma lista com os itens intercalados da lista original, com base numa contagem, num repeatInterval opcional e num deslocamento opcional.
List.Buffer Armazena a lista em buffer na memória. O resultado desta chamada é uma lista estável, o que significa que terá uma contagem determinímica e ordem dos itens.
List.Distinct Filtra uma lista removendo duplicatas. Um valor opcional de critérios de equação pode ser especificado para controlar a comparação de igualdade. É escolhido o primeiro valor de cada grupo de igualdade.
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 estiver vazio. Retorna o primeiro item da lista, ou o valor padrão opcional, se a lista estiver vazia. Se a lista estiver vazia e um valor padrão não for especificado, a função retornará.
List.FirstN Devolve o primeiro conjunto de itens da lista especificando quantos itens devolver ou uma condição de qualificação fornecida pelo countOrCondition.
List.InsertRange Insere itens a partir dos valores na posição fornecida na lista de entrada.
List.IsDistinct Retorna se uma lista é distinta.
List.Last Devolve o último conjunto de itens da lista especificando quantos itens devolver ou uma condição de qualificação fornecida pelo countOrCondition.
List.LastN Retorna o último conjunto de itens em uma lista especificando quantos itens retornar ou uma condição de qualificação.
List.MatchesAll Retorna "verdadeiro" se todos os itens de uma lista cumprirem uma condição.
List.MatchesAny Retorna verdadeiro se qualquer item numa lista satisfizer uma condição.
List.Positions Retorna uma lista de posições de uma lista fornecida.
List.Range Retorna o número de itens começando a partir de um ponto de partida.
List.Select Seleciona os itens que correspondem a uma condição.
List.Single Retorna o único item da lista ou lança uma Expression.Error se a lista tiver mais de um item.
List.SingleOrDefault Retorna um único item de uma lista.
List.Skip Ignora o primeiro item da lista. Dada uma lista vazia, ele retorna uma lista vazia. Esta função usa um parâmetro opcional countOrCondition para suportar ignorar vários valores.

Funções de transformação

Nome Descrição
List.Accumulate Acumula um resultado da lista. A partir do valor inicial de semente, esta função aplica a função acumuladora e retorna o resultado final.
List.Combine Mescla uma lista de listas em uma única lista.
List.ConformToPageReader Esta função destina-se apenas a uso interno.
List.RemoveRange Retorna uma lista que remove um número de itens começando a partir de um determinado 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 countOrCondition opcional.
List.RemoveItems Remove itens de list1 que estão presentes no list2e 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 countOrCondition opcional.
List.Repeat Devolve uma lista que repete o conteúdo de uma lista um número específico de vezes.
List.ReplaceRange Retorna uma lista que substitui os valores de contagem de uma lista por uma lista replaceWith, começando a partir de um índice.
List.RemoveMatchingItems Remove todas as ocorrências dos valores fornecidos na lista.
List.RemoveNulls Remove valores nulos de uma lista.
List.ReplaceMatchingItems Substitui ocorrências de valores existentes na lista por novos valores usando o equationCriteriafornecido. Valores antigos e novos são fornecidos pelos parâmetros replacements. Um valor opcional de critérios de equação pode ser especificado para controlar comparações de igualdade. Para obter detalhes sobre as operações de substituição e os critérios das equações, consulte Valores de parâmetro.
List.ReplaceValue Pesquisa uma lista de valores para o valor e substitui cada ocorrência pelo valor de substituição.
List.Reverse Retorna uma lista que inverte a ordem dos itens.
List.Split Divide a lista especificada em uma lista de listas usando o tamanho de 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 a partir da 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 numa lista forem verdadeiras
List.AnyTrue Retorna verdadeiro se qualquer expressão numa lista for verdadeira
List.Contains Retorna verdadeiro se um valor for encontrado na lista.
List.ContainsAll Retorna verdadeiro se todos os itens em valores forem encontrados numa lista.
List.ContainsAny Retorna verdadeiro se algum item nos valores for encontrado numa lista.
List.PositionOf Localiza a primeira ocorrência de um valor em uma lista e retorna sua posição.
List.PositionOfAny Localiza a primeira ocorrência de qualquer valor em valores e retorna sua posição.

Definir operações

Nome Descrição
List.Difference Retorna os itens na 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 nas listas individuais. Há suporte para valores duplicados.
List.Union Retorna uma única lista a partir de uma lista de listas e une os itens nas listas individuais. A lista retornada contém todos os itens em quaisquer listas de entrada. Os valores duplicados são combinados como parte da unificação de conjuntos.
List.Zip Devolve uma lista de listas que combinam itens na mesma posição.

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 item máximo em uma lista ou o valor padrão opcional se a lista estiver vazia.
List.MaxN Devolve os valores máximos na lista. O número de valores a retornar ou uma condição de filtragem deve ser especificado.
List.Median Devolve 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 estiver vazia.
List.MinN Devolve os valores mínimos numa lista. O número de valores a retornar ou uma condição de filtragem pode ser especificado.
List.Sort Retorna uma lista classificada usando o critério de comparação.
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 Retorna um valor médio de uma lista no tipo de dados dos valores na lista.
List.Mode Retorna um item que aparece com mais frequência em uma lista.
List.Modes Retorna todos os itens que aparecem com a mesma frequência máxima.
List.StandardDeviation Devolve o desvio padrão de uma lista de valores. List.StandardDeviation 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 Devolve a soma de uma lista de elementos.

Números

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

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

Geradores

Estas funções geram uma lista de valores.

Nome Descrição
List.Dates Retorna uma lista de valores de data da contagem de tamanhos, começando no início, e adiciona um incremento a cada valor.
List.DateTimes Retorna uma lista de valores de data e hora a partir de uma contagem definida, começando em start e adiciona um incremento a cada valor.
List.DateTimeZones Retorna uma lista de valores de fuso data/hora da contagem de tamanhos, 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 tamanhos, 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 na inicial e adiciona um incremento. O incremento assume como padrão 1.
List.Random Retorna uma lista de números aleatórios de contagem, com um parâmetro seed opcional.
List.Times Retorna uma lista de valores de tempo de contagem de tamanho, começando no início.

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.