Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Adicionado "Veja também" conforme comentário


 

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