Funções de listaList functions

Essas funções criam e manipulam valores de lista.These functions create and manipulate list values.

InformaçõesInformation

FunçãoFunction DescriçãoDescription
List.CountList.Count Retorna o número de itens em uma lista.Returns the number of items in a list.
List.NonNullCountList.NonNullCount Retorna o número de itens em uma lista excluindo valores nulosReturns the number of items in a list excluding null values
List.IsEmptyList.IsEmpty Retorna uma mensagem informando se uma lista está vazia.Returns whether a list is empty.

SeleçãoSelection

FunçãoFunction DescriçãoDescription
List.AlternateList.Alternate Retorna uma lista com os itens alternados da lista original baseado em uma contagem, repeatInterval opcional e um deslocamento opcional.Returns a list with the items alternated from the original list based on a count, optional repeatInterval, and an optional offset.
List.BufferList.Buffer Armazena em buffer a lista na memória.Buffers the list in memory. O resultado dessa chamada é uma lista estável, o que significa que ela terá uma ordem dos itens e uma contagem determinísticas.The result of this call is a stable list, which means it will have a determinimic count, and order of items.
List.DistinctList.Distinct Filtra uma lista removendo duplicatas.Filters a list down by removing duplicates. Um valor de critérios de equação opcional pode ser especificado para controlar a comparação de igualdade.An optional equation criteria value can be specified to control equality comparison. O primeiro valor de cada grupo de igualdade é escolhido.The first value from each equality group is chosen.
List.FindTextList.FindText Pesquisa uma lista de valores, incluindo campos de registro, para um valor de texto.Searches a list of values, including record fields, for a text value.
List.FirstList.First Retorna o primeiro valor da lista ou o padrão especificado se ela está vazia.Returns the first value of the list or the specified default if empty. Retorna o primeiro item da lista ou o valor padrão opcional se a lista está vazia.Returns the first item in the list, or the optional default value, if the list is empty. Se a lista estiver vazia e um valor padrão não for especificado, a função retornará.If the list is empty and a default value is not specified, the function returns.
List.FirstNList.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.Returns the first set of items in the list by specifying how many items to return or a qualifying condition provided by countOrCondition.
List.InsertRangeList.InsertRange Insere itens de valores no índice fornecido na lista de entrada.Inserts items from values at the given index in the input list.
List.IsDistinctList.IsDistinct Retorna uma mensagem informando se uma lista é distinta.Returns whether a list is distinct.
List.LastList.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.Returns the last set of items in the list by specifying how many items to return or a qualifying condition provided by countOrCondition.
List.LastNList.LastN Retorna o último conjunto de itens de uma lista especificando quantos itens devem ser retornados ou uma condição de qualificação.Returns the last set of items in a list by specifying how many items to return or a qualifying condition.
List.MatchesAllList.MatchesAll Retorna verdadeiro se todos os itens de uma lista atendem a uma condição.Returns true if all items in a list meet a condition.
List.MatchesAnyList.MatchesAny Retorna verdadeiro se qualquer item de uma lista atende a uma condição.Returns true if any item in a list meets a condition.
List.PositionsList.Positions Retorna uma lista de posições de uma lista de entrada.Returns a list of positions for an input list.
List.RangeList.Range Retorna uma contagem de itens começando em um deslocamento.Returns a count items starting at an offset.
List.SelectList.Select Seleciona os itens que correspondem a uma condição.Selects the items that match a condition.
List.SingleList.Single Retorna o único item da lista ou gera um Expression.Error se a lista tem mais de um item.Returns the single item of the list or throws an Expression.Error if the list has more than one item.
List.SingleOrDefaultList.SingleOrDefault Retorna um único item de uma lista.Returns a single item from a list.
List.SkipList.Skip Ignora o primeiro item da lista.Skips the first item of the list. Considerando uma lista vazia, ele retorna uma lista vazia.Given an empty list, it returns an empty list. Essa função usa um parâmetro opcional countOrCondition para dar suporte ao recurso de ignorar vários valores.This function takes an optional parameter countOrCondition to support skipping multiple values.

Funções de transformaçãoTransformation functions

FunçãoFunction DescriçãoDescription
List.AccumulateList.Accumulate Acumula um resultado da lista.Accumulates a result from the list. Começando na semente de valor inicial, essa função aplica a função de acumulador e retorna o resultado final.Starting from the initial value seed this function applies the accumulator function and returns the final result.
List.CombineList.Combine Mescla uma lista de listas em uma só lista.Merges a list of lists into single list.
List.ConformToPageReaderList.ConformToPageReader Esta função destina-se somente a uso interno.This function is intended for internal use only.
List.RemoveRangeList.RemoveRange Retorna uma lista que remove itens de contagem começando no deslocamento.Returns a list that removes count items starting at offset. A contagem padrão é 1.The default count is 1.
List.RemoveFirstNList.RemoveFirstN Retorna uma lista com o número especificado de elementos removidos da lista, começando no primeiro elemento.Returns a list with the specified number of elements removed from the list starting at the first element. O número de elementos removidos depende do parâmetro opcional countOrCondition.The number of elements removed depends on the optional countOrCondition parameter.
List.RemoveItemsList.RemoveItems Remove itens de list1 que estão presentes em list2 e retorna uma nova lista.Removes items from list1 that are present in list2, and returns a new list.
List.RemoveLastNList.RemoveLastN Retorna uma lista com o número especificado de elementos removidos da lista, começando no último elemento.Returns a list with the specified number of elements removed from the list starting at the last element. O número de elementos removidos depende do parâmetro opcional countOrCondition.The number of elements removed depends on the optional countOrCondition parameter.
List.RepeatList.Repeat Retorna uma lista que repete o conteúdo do número de contagens de uma lista de entrada.Returns a list that repeats the contents of an input list count times.
List.ReplaceRangeList.ReplaceRange Retorna uma lista que substitui valores de contagem em uma lista por uma lista replaceWith começando em um índice.Returns a list that replaces count values in a list with a replaceWith list starting at an index.
List.RemoveMatchingItemsList.RemoveMatchingItems Remove todas as ocorrências dos valores especificados na lista.Removes all occurrences of the given values in the list.
List.RemoveNullsList.RemoveNulls Remove os valores nulos de uma lista.Removes null values from a list.
List.ReplaceMatchingItemsList.ReplaceMatchingItems Substitui as ocorrências de valores existentes na lista por novos valores usando o equationCriteria fornecido.Replaces occurrences of existing values in the list with new values using the provided equationCriteria. Os valores novos e antigos são fornecidos pelos parâmetros de substituição.Old and new values are provided by the replacements parameters. Um valor de critérios de equação opcional pode ser especificado para controlar comparações de igualdade.An optional equation criteria value can be specified to control equality comparisons. Para obter detalhes sobre operações de substituição e critérios de equação, confira Valores de parâmetros.For details of replacement operations and equation criteria, see Parameter Values.
List.ReplaceValueList.ReplaceValue Pesquisa o valor em uma lista de valores e substitui cada ocorrência pelo valor de substituição.Searches a list of values for the value and replaces each occurrence with the replacement value.
List.ReverseList.Reverse Retorna uma lista que reverte os itens em uma lista.Returns a list that reverses the items in a list.
List.SplitList.Split Divide a lista especificada em uma lista de listas usando o tamanho da página especificado.Splits the specified list into a list of lists using the specified page size.
List.TransformList.Transform Executa a função em cada item da lista e retorna a nova lista.Performs the function on each item in the list and returns the new list.
List.TransformManyList.TransformMany Retorna uma lista cujos elementos são projetados com base na lista de entrada.Returns a list whose elements are projected from the input list.

Funções de associaçãoMembership functions

Como todos os valores podem ser testados quanto à igualdade, essas funções podem operar em listas heterogêneas.Since all values can be tested for equality, these functions can operate over heterogeneous lists.

FunçãoFunction DescriçãoDescription
List.AllTrueList.AllTrue Retorna verdadeiro se todas as expressões de uma lista são verdadeirasReturns true if all expressions in a list are true
List.AnyTrueList.AnyTrue Retorna verdadeiro se qualquer expressão de uma lista é verdadeiraReturns true if any expression in a list in true
List.ContainsList.Contains Retorna verdadeiro se um valor é encontrado em uma lista.Returns true if a value is found in a list.
List.ContainsAllList.ContainsAll Retorna verdadeiro se todos os itens nos valores são encontrados em uma lista.Returns true if all items in values are found in a list.
List.ContainsAnyList.ContainsAny Retorna verdadeiro se qualquer item nos valores é encontrado em uma lista.Returns true if any item in values is found in a list.
List.PositionOfList.PositionOf Encontra a primeira ocorrência de um valor em uma lista e retorna a posição dela.Finds the first occurrence of a value in a list and returns its position.
List.PositionOfAnyList.PositionOfAny Encontra a primeira ocorrência de qualquer valor nos valores e retorna a posição dela.Finds the first occurrence of any value in values and returns its position.

Operações de conjuntosSet operations

FunçãoFunction DescriçãoDescription
List.DifferenceList.Difference Retorna os itens da lista 1 que não aparecem na lista 2.Returns the items in list 1 that do not appear in list 2. Há suporte para valores duplicados.Duplicate values are supported.
List.IntersectList.Intersect Retorna uma lista de uma lista de listas e intersecciona itens comuns em listas individuais.Returns a list from a list of lists and intersects common items in individual lists. Há suporte para valores duplicados.Duplicate values are supported.
List.UnionList.Union Retorna uma lista de uma lista de listas e une os itens nas listas individuais.Returns a list from a list of lists and unions the items in the individual lists. A lista retornada contém todos os itens em listas de entrada.The returned list contains all items in any input lists. É feita a correspondência dos valores duplicados como parte da união.Duplicate values are matched as part of the Union.
List.ZipList.Zip Retorna uma lista de listas combinando itens na mesma posição.Returns a list of lists combining items at the same position.

OrdenandoOrdering

As funções de ordenação fazem comparações.Ordering functions perform comparisons. Todos os valores comparados precisam ser comparáveis entre si.All values that are compared must be comparable with each other. Isso significa que todos eles precisam ser provenientes do mesmo tipo de dados (ou incluir nulo, que sempre compara o menor).This means they must all come from the same datatype (or include null, which always compares smallest). Caso contrário, um Expression.Error é gerado.Otherwise, an Expression.Error is thrown.

Tipos de dados comparáveisComparable data types

  • NúmeroNumber

  • DuraçãoDuration

  • DatetimeDateTime

  • TextoText

  • LógicoLogical

  • NuloNull

FunçãoFunction DescriçãoDescription
List.MaxList.Max Retorna o item máximo em uma lista ou o valor padrão opcional se a lista está vazia.Returns the maximum item in a list, or the optional default value if the list is empty.
List.MaxNList.MaxN Retorna os valores máximos na lista.Returns the maximum values in the list. Depois que as linhas são classificadas, parâmetros opcionais podem ser especificados para filtrar ainda mais o resultadoAfter the rows are sorted, optional parameters may be specified to further filter the result
List.MedianList.Median Retorna o item mediano de uma lista.Returns the median item from a list.
List.MinList.Min Retorna o item mínimo em uma lista ou o valor padrão opcional se a lista está vazia.Returns the minimum item in a list, or the optional default value if the list is empty.
List.MinNList.MinN Retorna os valores mínimos em uma lista.Returns the minimum values in a list.
List.SortList.Sort Retorna uma lista classificada usando o critério de comparação.Returns a sorted list using comparison criterion.

AveragesAverages

Essas funções operam em listas homogêneas de Numbers, DateTimes e Durations.These functions operate over homogeneous lists of Numbers, DateTimes, and Durations.

FunçãoFunction DescriçãoDescription
List.AverageList.Average Retorna um valor médio de uma lista no tipo de dados dos valores na lista.Returns an average value from a list in the datatype of the values in the list.
List.ModeList.Mode Retorna um item que aparece mais comumente em uma lista.Returns an item that appears most commonly in a list.
List.ModesList.Modes Retorna todos os itens que aparecem com a mesma frequência máxima.Returns all items that appear with the same maximum frequency.
List.StandardDeviationList.StandardDeviation Retorna o desvio padrão de uma lista de valores.Returns the standard deviation from a list of values. List.StandardDeviation faz uma estimativa baseada em amostra.List.StandardDeviation performs a sample based estimate. O resultado é um número de números e uma duração de DateTimes e Durations.The result is a number for numbers, and a duration for DateTimes and Durations.

AdiçãoAddition

Essas funções operam em listas homogêneas de Numbers ou Durations.These functions work over homogeneous lists of Numbers or Durations.

FunçãoFunction DescriçãoDescription
List.SumList.Sum Retorna a soma de uma lista.Returns the sum from a list.

NuméricosNumerics

Essas funções só operam em números.These functions only work over numbers.

FunçãoFunction DescriçãoDescription
List.CovarianceList.Covariance Retorna a covariância de duas listas como um número.Returns the covariance from two lists as a number.
List.ProductList.Product Retorna o produto de uma lista de números.Returns the product from a list of numbers.

GeradoresGenerators

Essas funções geram uma lista de valores.These functions generate list of values.

FunçãoFunction DescriçãoDescription
List.DatesList.Dates Retorna uma lista de valores de data da contagem de tamanho, começando no início, e adiciona um incremento a cada valor.Returns a list of date values from size count, starting at start and adds an increment to every value.
List.DateTimesList.DateTimes Retorna uma lista de valores de datetime da contagem de tamanho, começando no início, e adiciona um incremento a cada valor.Returns a list of datetime values from size count, starting at start and adds an increment to every value.
List.DateTimeZonesList.DateTimeZones Retorna uma lista de valores de datetimezone da contagem de tamanho, começando no início, e adiciona um incremento a cada valor.Returns a list of of datetimezone values from size count, starting at start and adds an increment to every value.
List.DurationsList.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.Returns a list of durations values from size count, starting at start and adds an increment to every value.
List.GenerateList.Generate Gera uma lista com base em uma função de valor, uma função de condição, uma função next e uma função de transformação opcional nos valores.Generates a list from a value function, a condition function, a next function, and an optional transformation function on the values.
List.NumbersList.Numbers Retorna uma lista de números da contagem de tamanho, começando no início, e adiciona um incremento.Returns a list of numbers from size count starting at initial, and adds an increment. O incremento usa 1 como padrão.The increment defaults to 1.
List.RandomList.Random Retorna uma lista de números aleatórios de contagem, com um parâmetro de semente opcional.Returns a list of count random numbers, with an optional seed parameter.
List.TimesList.Times Retorna uma lista de valores de tempo da contagem de tamanho, começando no início.Returns a list of time values of size count, starting at start.

Valores de parâmetroParameter values

Especificação de ocorrênciaOccurrence specification

  • Occurrence.First = 0;Occurrence.First = 0;

  • Occurrence.Last = 1;Occurrence.Last = 1;

  • Occurrence.All = 2;Occurrence.All = 2;

Ordem de classificaçãoSort order

  • Order.Ascending = 0;Order.Ascending = 0;

  • Order.Descending = 1;Order.Descending = 1;

Critérios de equaçãoEquation criteria

Os critérios de equação para valores de lista podem ser especificados comoEquation criteria for list values can be specified as either a

  • Um valor de função que éA function value that is either

    • Um seletor de chave que determina o valor na lista para aplicar os critérios de igualdade ouA key selector that determines the value in the list to apply the equality criteria, or

    • Uma função de comparador que é usada para especificar o tipo de comparação a ser aplicado.A comparer function that is used to specify the kind of comparison to apply. As funções de comparador internas podem ser especificadas; confira a seção Funções de comparação.Built in comparer functions can be specified, see section for Comparer functions.

  • Um valor de lista que tenhaA list value which has

    • Exatamente dois itensExactly two items

    • O primeiro elemento é o seletor de chave, conforme especificado acimaThe first element is the key selector as specified above

    • O segundo elemento é um comparador, conforme especificado acima.The second element is a comparer as specified above.

Para obter mais informações e exemplos, confira List.Distinct.For more information and examples, see List.Distinct.

Critérios de comparaçãoComparison criteria

O critério de comparação pode ser fornecido como um dos seguintes valores:Comparison criterion can be provided as either of the following values:

  • Um valor numérico para especificar uma ordem de classificação.A number value to specify a sort order. Para obter mais informações, confira a ordem de classificação em Valores de parâmetros.For more inforarmtion, see sort order in Parameter values.

  • Para calcular uma chave a ser usada para classificação, uma função de um argumento pode ser usada.To compute a key to be used for sorting, a function of 1 argument can be used.

  • 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.To both select a key and control order, comparison criterion can be a list containing the key and order.

  • 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.To completely control the comparison, a function of 2 arguments can be used that returns -1, 0, or 1 given the relationship between the left and right inputs. Value.Compare é um método que pode ser usado para delegar essa lógica.Value.Compare is a method that can be used to delegate this logic.

Para obter mais informações e exemplos, confira List.Sort.For more information and examples, see List.Sort.

Operações de substituiçãoReplacement operations

As operações de substituição são especificadas por um valor de lista. Cada item dessa lista precisa serReplacement operations are specified by a list value, each item of this list must be

  • Um valor de lista com exatamente dois itensA list value of exactly two items

  • O primeiro item é o valor antigo na lista, a ser substituídoFist item is the old value in the list, to be replaced

  • O segundo item é o novo, que deve substituir todas as ocorrências do valor antigo na listaSecond item is the new which should replace all occurrences of the old value in the list