Compartilhar via


Text.StartsWith

Sintaxe

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

Sobre

Retornará true se o valor de texto text começar com o valor de texto substring.

  • text: Um valor text que deve ser pesquisado.
  • substring: Um valor text que é a subcadeia de caracteres a ser pesquisada em text.
  • comparer: [opcional] Um Comparer usado para controlar a comparação. Por exemplo, Comparer.OrdinalIgnoreCase pode ser usado para executar pesquisas que não diferenciam maiúsculas de minúsculas.

comparer é um Comparer usado para controlar a comparação. Os comparadores podem ser usados para fornecer 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 exata.
  • Comparer.OrdinalIgnoreCase: Usado para realizar uma comparação ordinal exata sem distinção entre maiúsculas e minúsculas.
  • Comparer.FromCulture: usado para executar uma comparação com reconhecimento de cultura.

Exemplo 1

Verifique se o texto "Olá, Mundo" começa com o texto "olá".

Usage

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

Saída

false

Exemplo 2

Verifique se o texto "Olá, Mundo" começa com o texto "Olá".

Usage

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

Saída

true

Exemplo 3

Ignorando maiúsculas e minúsculas, verifique se o texto "Olá, Mundo" começa com o texto "olá".

Usage

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

Saída

true