Text.Contains

Sintaxe

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

Sobre

Detecta se text contém o valor substring. Retornará true se o valor for encontrado. Essa função não dá suporte a curingas ou expressões regulares.

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

  • Comparer.Ordinal: usado para executar uma comparação ordinal que diferencia maiúsculas de minúsculas
  • Comparer.OrdinalIgnoreCase: usado para executar uma comparação ordinal que não diferencia maiúsculas de minúsculas
  • Comparer.FromCulture: usado para executar uma comparação com detecção de cultura

Exemplo 1

Descubra se o texto "Olá, Mundo" contém "Olá".

Usage

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

Saída

true

Exemplo 2

Descubra se o texto "Olá, Mundo" contém "olá".

Usage

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

Saída

false

Exemplo 3

Descubra se o texto “Olá, Mundo” contém “Olá”, usando um comparador que não diferencia maiúsculas de minúsculas.

Usage

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

Saída

true