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 realizar pesquisas sem distinção entre maiúsculas e 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 realizar 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á".

Uso

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

Saída

true