Histórico da Página

Sintaxe 

POSICIONE( <cAlias>, <nOrdem>, <cChave>, <cCampo> ) 

Propósito 

Retorna o conteúdo de um campo de um arquivo de dados, de acordo com uma chave de pesquisa. 

Argumentos

<cAlias>

Define o alias do arquivo cujo campo terá o seu conteúdo retornado. 

<nOrdem>

Define o índice que será utilizado para a pesquisa. Informa-se a ordem do índice.

<cChave>

Chave de pesquisa utilizada para se encontrar o registro do qual o conteúdo de um determinado campo será retornado.

<cCampo> 

Define o nome do campo cujo conteúdo será retornado. 

Utilização

Recomenda-se que a utilização da função POSICIONE() seja protegida com a utilização das funções GETAREA() e RESTAREA(), dependendo da aplicação. Com isso, salva-se o ambiente anterior, pois a função POSICIONE() desposiciona o ponteiro do arquivo.

Exemplos 

Nesse exemplo, a função POSICIONE() pesquisa o arquivo SB1, na ordem 1, para retornar o conteúdo do campo B1_DESC. 

LOCAL cDesc := “” 

cDesc := POSICIONE(“SB1”, 1, xFilial(“SB1”) + AB2->AB2_CODPRO, “B1_DESC”)

Veja Também

RETFIELD

GetAdvFval