SYS(2021) - Expresión de índice filtrado

  • Artículo

Devuelve la expresión de filtro para un archivo abierto de índice de entrada simple (.idx) o las expresiones de filtro para las etiquetas de archivos de índice compuesto (.cdx).

SYS(2021, nIndexNumber [, nWorkArea | cTableAlias])

Valores devueltos

Character

Parámetros

  • nIndexNumber
    La expresión numérica nIndexNumber especifica qué expresión de filtro se va a devolver desde los archivos de índice abiertos. SYS(2021) devuelve expresiones de filtro desde los archivos de índice abiertos en el orden siguiente, a medida que nIndexNumber aumenta desde 1 hasta alcanzar el número total de archivos de entrada simple abiertos .idx y de etiquetas de índice compuesto estructural e independiente:

    1. Primero se devuelven las expresiones de filtro de los archivos .idx de entrada simple (si hay alguno abierto). El orden en que los archivos .idx de entrada simple se incluyen en USE o SET INDEX determina el orden en que se devolverán las expresiones de filtro.
    2. A continuación se devuelven las expresiones de filtro para cada etiqueta del archivo .cdx estructural (si hay alguno presente). Las expresiones de filtro se devuelven a partir de las etiquetas en el orden en que éstas se crearon en el índice estructural.
    3. Por último, se devuelven las expresiones de filtro para cada etiqueta de cualquier archivo .cdx independiente abierto. Las expresiones de filtro se devuelven a partir de las etiquetas en el orden en que éstas se crearon en los índices compuestos independientes.

    Si nIndexNumber es mayor que el número total de archivos de entrada simple abiertos .idx y que las etiquetas de archivos estructurales e independientes .cdx, se devuelve la cadena vacía.

  • nWorkArea
    Especifica el número del área de trabajo para una tabla abierta en otra área de trabajo.

  • cTableAlias
    Especifica un alias para una tabla abierta en otra área de trabajo. Si una tabla no tiene el alias especificado, Visual FoxPro mostrará un mensaje de error.

Observaciones

Es posible crear índices filtrados en Visual FoxPro. Si incluye la cláusula opcional FOR en INDEX, el archivo de índice actuará como filtro para la tabla. Sólo estarán disponibles para su presentación y acceso los registros que coincidan con la expresión de filtro lExpression de la cláusula FOR. Las claves de índice se crean en el archivo de índice sólo para los registros que coinciden con la expresión de filtro.

Si se crea un índice o una etiqueta de índice sin la cláusula FOR, se devolverá una cadena vacía.

USE y SET INDEX admiten el uso de una lista de nombres de archivos de índice que permita abrir archivos de índice para una tabla. En la lista de nombres de archivos de índice puede incluirse cualquier combinación de nombres de archivos .idx de entrada simple, archivos .cdx estructurales y archivos .idx independientes.

SYS(2021) devuelve las expresiones de filtro a partir de los archivos de índice abiertos en el área de trabajo actual, a menos que incluya un alias o un área de trabajo determinados.

Vea también

CDX( ) | KEY( ) | INDEX | MDX( ) | NDX( ) | REINDEX | SET INDEX | SET ORDER | SYS( ) Introducción a las funciones | TAG( )