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”)