Pular para o conteúdo principal

Text.Contains

Especifica se o texto contém a subcadeia de caracteres.

Syntax​

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

Remarks​

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

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

  • Comparer.Ordinal: usado para realizar uma comparação ordinal com distinção entre maiúsculas e minúsculas
  • Comparer.OrdinalIgnoreCase: usado para realizar uma comparação ordinal sem diferenciar maiúsculas de minúsculas
  • Comparer.FromCulture: usado para realizar uma comparação com reconhecimento de cultura

Examples​

Example #1​

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

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

Result:

true

Example #2​

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

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

Result:

false

Example #3​

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

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

Result:

true

Category​

Text.Membership