Ler em inglês

Partilhar via


Text.PositionOf

Sintaxe

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

Acerca de

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

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 consciente da cultura

Exemplo 1

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

Utilização

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

Saída

7

Exemplo 2

Obter a posição de última ocorrência de "Mundo" em "Olá, Mundo! Olá, Mundo!".

Utilização

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

Saída

21