Saltar para o conteúdo principal

Text.Contains

Indica se o texto contém a subcadeia.

Syntax​

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

Remarks​

Deteta se text contém o valor substring. Devolve "true" se o valor for encontrado. Esta função não suporta carateres universais nem expressões regulares.

O argumento opcional comparer pode ser utilizado para especificar comparações não sensíveis a maiúsculas/minúsculas ou baseadas na cultura ou na região. Os comparadores incorporados que se seguem estão disponíveis na linguagem da fórmula:

  • Comparer.Ordinal: utilizado para executar uma comparação ordinal exata
  • Comparer.OrdinalIgnoreCase: utilizado para executar uma comparação ordinal exata não sensível a maiúsculas/minúsculas
  • Comparer.FromCulture: utilizado para executar uma comparação baseada na cultura

Examples​

Example #1​

Determinar se o texto "Olá Mundo" contém "Olá".

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

Result:

true

Example #2​

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

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

Result:

false

Example #3​

Saiba se o texto "Hello World" contém a palavra "hello", utilizando um comparador não sensível a maiúsculas/minúsculas.

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

Result:

true

Category​

Text.Membership