TOTVSTEC

Árvore de páginas

Retorna a posição da última ocorrência de uma substring em uma string. Para isso, a função pesquisa a string destino a partir da direita.

Sintaxe

RAt( < cSearch >, < cSource > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cSearch

caractere

Indica a string que será localizada.

X

 

cSource

caractere

Indica a string onde <cSearch> será procurada.

X

 

Retorno

Nome

Tipo

Descrição

nRet

numérico

Retorna a posição da string localizada, dentro da procurada, na forma de um valor numérico inteiro.

Observações

  • Caso <cSearch> não seja localizada em <cSource>, o retorno será 0 (zero).
  • Essa função é semelhante a At, que retorna a posição da primeira ocorrência de uma substring em uma string, e ao operador $, que determina se uma substring está contida em uma string.
  • As funções RAt e At são utilizadas em conjunto com as funções SubStr, Left e Right para extrair substrings.

Exemplos

Exemplo 1
User Function Exemplo()
  cPesq := "@"
  cText := "Linha @ para pesquisa @ de RAT"
  RAt( cPesq, cText ) // Resultado: 23 // Localizou a posição do último "@" na frase
return

Abrangência

Advanced Protheus 6.09, Advanced Protheus 7.10, Microsiga Protheus 8.11, Protheus 10

Veja também

  • Sem rótulos