EXISTCHAV()

Sintaxis

ExistChav( <alias>, <expressão>  [ , <índice> ]  [ , <help> ] )

Propósito

Verifica si el contenido especificado existe en el archivo de datos.

Argumentos

<alias>

Alias del archivo de datos en el que se buscará y validará la información.

<expresión>

Clave que se buscará. Se debe definir sin la sucursal.

<índice>

Índice que se utilizará para buscar la expresión en el archivo de datos.

Este argumento es opcional. Si no se informa, la función asume que se utilizará el primer índice del archivo de datos.

<help>

Nombre del help estándar del Protheus que se mostrará al usuario. Este argumento es opcional.

Utilización

Por lo general, esta función se utiliza para verificar si un determinado código ya existe en el archivo de datos en la que está incluida la información. Por ejemplo, el registro CNPJ en el Archivo de Clientes o Proveedores.

Si el contenido especificado existe en el alias (archivo de datos), la función vuelve verdadero (.T.). Si no existe, vuelve falso (.F.) y muestra un help informando lo ocurrido.

Sugerencias

A primera vista, las funciones ExistCpo() y ExistChav() parecen similares. Pero, la función ExistCpo() verifica una clave externa (extranjera), es decir, verifica si un código existe en otro archivo de datos, mientras que la función ExistChav() verifica una clave única, o sea, verifica si un código ya existe en el mismo archivo de datos que se está manejando.

Ejemplos

FUNCTION VerCli(cCNPJ, cInscEst)

// Verifica si los registros CNPJ e Inscripción Estatal ya existen en el Archivo de Clientes.

IF ExistChav("SA1", xFilial("SA1") + cCNPJ + cInscEst, 9, "EXISTCLI")

          nCliente += 1

ELSE

          nProspec += 1

ENDIF

RETURN NIL