Compartilhar via


List.Contains

Sintaxe

List.Contains(
    list as list,
    value as any,
    optional equationCriteria as any
) as logical

Sobre

Indica se a lista contém o valor especificado. Retorna true se o valor for encontrado na lista, false caso contrário.

  • list: a lista a ser pesquisada.
  • value: o valor a ser pesquisado na lista.
  • equationCriteria: (Opcional) O comparador usado para determinar se os dois valores são iguais.

Exemplo 1

Determine se a lista {1, 2, 3, 4, 5} contém 3.

Uso

List.Contains({1, 2, 3, 4, 5}, 3)

Saída

true

Exemplo 2

Determine se a lista {1, 2, 3, 4, 5} contém 6.

Uso

List.Contains({1, 2, 3, 4, 5}, 6)

Saída

false

Exemplo 3

Ignorando maiúsculas e minúsculas, determine se a lista contém "ruibarbo".

Uso

List.Contains({"Pears", "Bananas", "Rhubarb", "Peaches"},
    "rhubarb",
    Comparer.OrdinalIgnoreCase
)

Saída

true

Exemplo 4

Determine se a lista contém a data de 8 de abril de 2022.

Uso

let
    Source = {#date(2024, 2, 23), #date(2023, 12, 2), #date(2022, 4, 8), #date(2021, 7, 6)},
    ContainsDate = List.Contains(Source, Date.From("4/8/2022"))
in
    ContainsDate

Saída

true

Critérios de equação