FOR( ) (Función)
Devuelve la expresión de filtro de índice, en mayúsculas, de un archivo de índice de una sola entrada (.idx) abierto o de una etiqueta de índice.
FOR([nIndexNumber [, nWorkArea | cTableAlias]])
Valores devueltos
Character
Parámetros
Si no incluye ninguno de los argumentos opcionales, FOR( ) devuelve la expresión de filtro de índice para el archivo de índice o la etiqueta de índice principal. Si no hay activo ningún archivo de índice ni ninguna etiqueta de índice principales (por ejemplo, si ha ejecutado SET ORDER TO para colocar la tabla en el orden físico de los registros), FOR( ) devuelve la cadena vacía.
- nIndexNumber
Especifica el archivo o la etiqueta de índice cuya expresión de filtro se devuelve. FOR( ) devuelve las expresiones de filtro en el siguiente orden, a medida que nIndexNumber aumenta de 1 al número total de archivos de una sola entrada abiertos y de etiquetas de índice compuesto estructural y compuesto independiente:
Primero devuelve las expresiones de filtro de archivos de índice de una sola entrada (si hay alguno abierto). El orden en que se incluyen los archivos de índice de una sola entrada en USE o SET INDEX determina el orden en que se devuelven las expresiones de filtro.
A continuación se devuelven las expresiones de filtro para cada etiqueta del índice compuesto estructural (si lo hay). Las expresiones de filtro de las etiquetas se devuelven en el orden en que se crearon dichas etiquetas en el índice estructural.
Por último se devuelven las expresiones de filtro para cada etiqueta de cualquier índice compuesto independiente. Las expresiones de filtro de las etiquetas se devuelven en el orden de creación de las etiquetas en los índices compuestos independientes.
Se devuelve la cadena vacía si un índice o una etiqueta de índice se crearon sin la cláusula FOR, o si nIndexNumber es mayor que el número total de archivos de índice de una sola entrada abiertos más las etiquetas de índice compuesto independiente y compuesto estructural.
nWorkArea
Especifica el área de trabajo de la tabla cuya expresión de filtro de índice devuelve FOR( ).FOR( ) devuelve la cadena vacía si no hay ninguna tabla abierta en el área de trabajo especificada.
cTableAlias
Especifica el alias de la tabla cuyas expresiones de filtro de índice devuelve FOR( ).Visual FoxPro genera un mensaje de error si especifica un alias de tabla que no existe.
Observaciones
Es posible crear índices filtrados en Visual FoxPro. Si incluye la cláusula opcional FOR lExpression en INDEX, el archivo de índice actúa como filtro en la tabla. Solamente están disponibles para su visualización y acceso los registros que coincidan con la expresión de filtro lExpression. Las claves de índice se crean en el archivo de índice solamente para los registros que coincidan con la expresión de filtro.
Tanto USE como SET INDEX admiten una lista de nombres de archivos de índice que permite abrir múltiples archivos de índice para una tabla. En la lista de nombres de archivos de índice se puede incluir cualquier combinación de nombres de archivo de índice de una sola entrada, compuesto estructural y compuesto independiente. FOR( ) es similar a SYS(2021) y se proporciona por compatibilidad con dBASE IV.