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 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 cultura e reconhecimento de localidade.

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

• Comparer.Ordinal: usado para executar uma comparação ordinal exata
• Comparer.OrdinalIgnoreCase: usado para executar uma comparação ordinal exata que não diferencia maiúsculas de minúsculas
• Comparer.FromCulture: usado para executar uma comparação com reconhecimento 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" em "Olá, Mundo! Olá, Mundo!".

Usage

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

Saída

21

Conteúdo relacionado

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