Text.StartsWith

Sintaxe

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

Sobre

Retorna verdadeiro se o valor do texto text começar com o valor do texto substring.

• text: Um text valor que deve ser pesquisado.
• substring: Um text valor que é a substring a ser pesquisada em text.
• comparer: [Opcional] Um Comparer utilizado 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 que é usado para controlar a comparação. Os comparadores podem ser usados para fornecer comparações que não diferenciam maiúsculas de minúsculas ou que reconhecem cultura e localidade.

Os seguintes comparadores incorporados estão disponíveis no idioma da fórmula:

• Comparer.Ordinal: Usado para realizar uma comparação ordinal exata.
• Comparer.OrdinalIgnoreCase: Usado para realizar uma comparação ordinal exata sem diferenciação de maiúsculas e minúsculas.
• Comparer.FromCulture: Usado para realizar uma comparação sensível à cultura.

Exemplo 1

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

Utilização

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

Saída

false

Exemplo 2

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

Utilização

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

Saída

true

Exemplo 3

Ignorando o caso, verifique se o texto "Olá, Mundo" começa com o texto "Olá".

Utilização

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

Saída

true

Conteúdo relacionado

• Como a cultura afeta a formatação de texto