Ler em inglês

Partilhar via


Text.Contém

Sintaxe

Text.Contains(text as nullable text, substring as text, optional comparer as nullable function) as nullable logical

Sobre

Deteta se text contém o valor substring. Retorna true se o valor for encontrado. Esta função não suporta curingas ou expressões regulares.

O argumento comparer opcional pode ser usado para especificar comparações sem diferenciação de maiúsculas e minúsculas ou com reconhecimento de cultura e localidade. Os seguintes comparadores incorporados estão disponíveis no idioma da fórmula:

Se o primeiro argumento for null, essa função retornará null.

Todos os caracteres são tratados literalmente. Por exemplo, "DR", " DR", "DR" e " DR " não são considerados iguais entre si.

Exemplo 1

Descubra se o texto "Hello World" contém "Hello".

Utilização

Text.Contains("Hello World", "Hello")

Saída

true

Exemplo 2

Descubra se o texto "Hello World" contém "hello".

Utilização

Text.Contains("Hello World", "hello")

Saída

false

Exemplo 3

Descubra se o texto "Hello World" contém "hello", usando um comparador que não diferencia maiúsculas de minúsculas.

Utilização

Text.Contains("Hello World", "hello", Comparer.OrdinalIgnoreCase)

Saída

true

Exemplo 4

Encontre as linhas em uma tabela que contêm "A-" ou "7" no código da conta.

Utilização

let
    Source = #table(type table [Account Code = text, Posted Date = date, Sales = number],
    {
        {"US-2004", #date(2023,1,20), 580},
        {"CA-8843", #date(2023,7,18), 280},
        {"PA-1274", #date(2022,1,12), 90},
        {"PA-4323", #date(2023,4,14), 187},
        {"US-1200", #date(2022,12,14), 350},
        {"PTY-507", #date(2023,6,4), 110}
    }),
    #"Filtered rows" = Table.SelectRows(
        Source, 
        each Text.Contains([Account Code], "A-") or
            Text.Contains([Account Code], "7"))
in
    #"Filtered rows"

Saída

#table(type table [Account Code = text, Posted Date = date, Sales = number],
{
    {"CA-8843", #date(2023,7,18), 280},
    {"PA-1274", #date(2022,1,12), 90},
    {"PA-4323", #date(2023,4,14), 187},
    {"PTY-507", #date(2023,6,4), 110}
})