Sintaxis
POSICIONE( <cAlias>, <nOrdem>, <cChave>, <cCampo> )
Propósito
Devuelve el contenido del campo de un archivo de datos, de acuerdo con una clave de búsqueda.
Argumentos
<cAlias>
Define el alias del archivo cuyo campo tendrá su contenido devuelto.
<nOrdem>
Define el índice que se utilizará para la búsqueda. Se informa el orden del índice.
<cChave>
Clave de búsqueda utilizada para encontrarse el registro del cual se devolverá el contenido de un determinado campo.
<cCampo>
Define el nombre del campo cuyo contenido se devolverá.
Utilización
Se recomienda que la utilización de la función POSICIONE() se proteja con la utilización de las funciones GETAREA() y RESTAREA(), dependiendo de la aplicación. Con ello, se graba el entorno anterior, pues la función POSICIONE() desmarca el puntero del archivo.
Ejemplos
En este ejemplo, la función POSICIONE()busca el archivo SB1, en el orden 1, para retornar el contenido del campo B1_DESC.
LOCAL cDesc := “”
cDesc := POSICIONE(“SB1”, 1, xFilial(“SB1”) + AB2->AB2_CODPRO, “B1_DESC”)