TOTVSTEC

Árvore de páginas

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

Sintaxe

At( < cPesquisa >, < cDestino >, [ nStart ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cPesquisa

caractere

Indica a string que será localizada.

X


cDestino

caractere

Indica a string que será procurada.

X


nStart

numérico

Indica a partir de qual caractere iniciará a busca (o nStart deverá ser maior que zero, caso contrário o retorno será 0)



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. Caso a string não seja localizada, o retorno será 0 (zero).

Exemplos

Exemplo 1
User Function Exemplo()
  cPesq := "@"
  cText := "Linha @ para pesquisa  de AT"
  AT( cPesq, cText ) // Resultado: 7
Return

Abrangência

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

Veja também