INDEXSEEK( ) (Función)

  • Artículo

Sin mover el puntero de los registros, busca en una tabla indizada la primera ocurrencia de un registro cuya clave de índice coincida con una expresión especificada.

INDEXSEEK(eExpression [, lMovePointer [, nWorkArea | cTableAlias
   [, nIndexNumber | cIDXIndexFileName | cTagName]]])

Valores devueltos

Logical

Parámetros

  • eExpression
    Especifica la expresión de la clave de índice sobre la que desea realizar una búsqueda con INDEXSEEK( ).

  • lMovePointer
    Especifica si el puntero de registro se desplazará al registro coincidente. Si lMovePointer es verdadero (.T.) y existe un registro coincidente, el puntero de registro se moverá al registro coincidente. Si lMovePointer es verdadero (.T.) y no existe ningún registro coincidente, el puntero de registro no se moverá. Si lMovePointer es falso (.F.) o se omite, el puntero de registro no se moverá incluso si existe un registro coincidente.

  • nWorkArea
    Especifica el número de área de trabajo de la tabla en la que se buscará la clave de índice.

  • cTableAlias
    Especifica el alias de la tabla en la que se realizará la búsqueda. Si omite nWorkArea y cTableAlias, se realizará una búsqueda en la tabla del área de trabajo actualmente seleccionada.

  • nIndexNumber
    Especifica el número del archivo de índice o la etiqueta utilizada para buscar la clave de índice. nIndexNumber se refiere a los archivos de índice tal y como aparecen en USE o SET INDEX. Los archivos .IDX abiertos están numerados primero en el orden en que aparecen en USE o SET INDEX. Las etiquetas en el archivo estructural .CDX (si existe) son entonces numeradas en el orden en el que son creados. Finalmente, las etiquetas de cualquier archivo independiente .CDX abierto se numeran en el orden en el que se crean. Para más información sobre la numeración indizada, consulte SET ORDER.

  • cIDXIndexFileName
    Especifica un archivo .idx que se utiliza para buscar la clave de índice.

  • cTagName
    Especifica la etiqueta de un archivo .CDX que se utiliza para buscar la clave de índice. El nombre de etiqueta puede pertenecer a un archivo .CDX estructural o a cualquier archivo .CDX independiente abierto.

    Nota   El archivo .IDX tiene prioridad si existen un archivo .IDX y nombres de etiqueta duplicados.

Observaciones

INDEXSEEK( ) devuelve verdadero (.T.) si se encuentra una coincidencia; de lo contrario devuelve falso (.F.). Se puede utilizar INDEXSEEK( ) sólo con una tabla que tenga un orden de índices establecido, y sólo se puede buscar una clave de índice. La coincidencia debe ser exacta a menos que SET EXACT esté en OFF (desactivado).

INDEXSEEK( ) proporciona una manera rápida de buscar registros sin mover el puntero de registro. Las reglas y desencadenadores no se ejecutan, ya que el puntero de registro no se desplaza. Si INDEXSEEK( ) devuelve verdadero (.T.) indicando que se ha encontrado un registro coincidente, puede ejecutar INDEXSEEK( ) de nuevo con el segundo parámetro lMovePointer establecido a verdadero (.T.) para desplazarse al registro coincidente.

Vea también

INDEX | KEYMATCH( ) | LOCATE | SEEK | SEEK( )