Ler em inglês

Partilhar via


Funções de lista

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

Informações

Name Description
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

Name Description
List.Suplente Retorna uma lista com os itens alternados da lista original com base em uma contagem, repeatInterval opcional e um 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 de valores no índice fornecido 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 pela countOrCondition.
List.LastN Retorna o último conjunto de itens em uma lista especificando quantos itens devem retornar ou uma condição de qualificação.
List.MatchesAll Retorna true se todos os itens de uma lista atenderem a uma condição.
List.MatchesAny Retorna true se qualquer item em uma lista atender a uma condição.
List.Posições Retorna uma lista de posições para uma lista de entrada.
List.Range Retorna uma contagem de itens começando em um deslocamento.
List.Selecione Seleciona os itens que correspondem a uma condição.
List.Single Retorna o único item da lista ou lança um se a lista tiver mais de um Expression.Error 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 countOrCondition opcional para suportar a pulação de vários valores.

Funções de transformação

Name Description
List.Acumular Acumula um resultado da lista. A partir do valor inicial semente, esta função aplica a função acumulador 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 os itens de contagem a partir do 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 que list1 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 opcional countOrCondition .
List.Repetir Retorna uma lista que repete o conteúdo de uma lista de entrada contando vezes.
List.ReplaceRange Retorna uma lista que substitui valores de contagem em uma lista por uma replaceWith lista que começa em 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 fornecido equationCriteria. Os valores antigos e novos são fornecidos pelos replacements parâmetros. Um valor opcional de critérios de equação pode ser especificado para controlar comparações de igualdade. Para obter detalhes sobre operações de substituição e critérios de equação, vá para 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 reverte os itens em uma lista.
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.

Name Description
List.AllTrue Retorna true se todas as expressões em uma lista forem true
List.AnyTrue Retorna true se qualquer expressão em uma lista for true
List.Contém Retorna true se um valor for encontrado em uma lista.
List.ContainsAll Retorna true se todos os itens em valores forem encontrados em uma lista.
List.ContémQualquer Retorna true se algum item em valores for encontrado em uma lista.
List.PositionOf Localiza a primeira ocorrência de um valor em uma lista e retorna sua posição.
List.PosiçãodeQualquer Localiza a primeira ocorrência de qualquer valor em valores e retorna sua posição.

Definir operações

Name Description
List.Diferença 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 cruza itens comuns em listas individuais. Há suporte para valores duplicados.
List.Union Retorna uma lista de uma lista de listas e uniões os itens nas listas individuais. A lista retornada contém todos os itens em quaisquer listas de entrada. Os valores duplicados são correspondidos como parte da União.
List.Zip Retorna uma lista de listas que combinam itens na mesma posição.

Ordenação

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

Os tipos de dados comparáveis incluem:

  • Número
  • Duração
  • DateTime
  • Texto
  • Lógico
  • Nulo
Name Description
List.Max Retorna o item máximo em uma lista ou o valor padrão opcional se a lista estiver vazia.
Lista.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.Mediana 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.
Lista.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.Percentil 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.

Name Description
Lista.Média 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.DesvioPadrão Devolve o desvio padrão de uma lista de valores. List.StandardDeviation executa uma estimativa baseada em amostra. O resultado é um número para números e uma duração para DateTimes e Durations.

Adição

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

Name Description
List.Soma Devolve a soma de uma lista.

Numéricos

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

Name Description
List.Covariance Devolve a covariância de duas listas como um número.
Lista.Produto Devolve o produto a partir de uma lista de números.

Geradores

Estas funções geram uma lista de valores.

Name Description
List.Datas 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 datetime da contagem de tamanhos, começando no início, 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.Durações 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.Gerar Gera uma lista de valores.
Lista.Números 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.Aleatório 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

Sequência de ordenaçã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 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 de comparação.
  • 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 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:

  • Um valor de lista de 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.