Ler em inglês

Compartilhar via


Text.PositionOf

Sintaxe

Text.PositionOf(text as text, substring as text, optional occurrence as nullable number, optional comparer as nullable function) as any

Sobre

Retorna a posição da ocorrência especificada do valor de texto substring encontrado em text. Um parâmetro opcional occurrence pode ser usado para especificar qual posição de ocorrência deve ser retornada (primeira ocorrência por padrão). Retorna -1 se substring não foi encontrado.

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 executar uma comparação ordinal exata sem diferenciação de maiúsculas e minúsculas
  • Comparer.FromCulture: usado para executar uma comparação com detecção de cultura

Exemplo 1

Obtenha a posição da primeira ocorrência de "Mundo" no texto "Olá, Mundo! Olá, Mundo!".

Usage

Text.PositionOf("Hello, World! Hello, World!", "World")

Saída

7

Exemplo 2

Obtenha a posição da última ocorrência de "Mundo" no texto "Olá, Mundo! Olá, Mundo!".

Usage

Text.PositionOf("Hello, World! Hello, World!", "World", Occurrence.Last)

Saída

21