BOF()

Sintaxis

BOF()

Propósito

Determina cuándo se encuentra el inicio del archivo.

Argumentos

Ninguno.

Utilización

La función BOF(), que significa beginning of file (inicio del archivo), suministra el valor lógico verdadero (.T.) cuando se realiza un intento de ubicar el apuntador de registros antes del primer registro lógico del archivo de datos en uso. Es decir, esta detecta el inicio del archivo de datos.

Cuando un archivo de datos no esté indexado, el primer registro será el primer registro físico, es decir, el registro número 1. En caso contrario, el primer registro será el primer registro lógico, es decir, de acuerdo con el orden establecido por el índice vigente.

Sugerencias

La función BOF() es lo inverso de la función EOF(), que significa end of file (final del archivo). Esta suministrar un verdadero (.T.) cuando se alcanza el final lógico de un archivo de datos.

Si el archivo de datos no contiene registros, las funciones BOF() y EOF() suministran el mismo valor verdadero (.T.). Por otro lado, si no existe ningún archivo de datos abierto en el área de trabajo seleccionada, ambas funciones suministran falso (.F.).

Por definición, la función BOF() actúa sobre el área de trabajo seleccionada. Sin embargo, esta puede verificar si el inicio de otro archivo de datos se alcanzó por medio de la utilización del alias de la otra área de trabajo. Por ejemplo:

DBSELECTAREA(“SC5”)

DBSELECTAREA(“SA1”)

MSGALERT( SC5->(BOF()) )   // Verifica el área de trabajo del Archivo SC5.

MSGALERT( BOF() )                // Verifica el área de trabajo corriente. En este caso, la del Archivo SA1.

Ejemplos

El siguiente ejemplo muestra la utilización de la función BOF() al intentar ubicar el puntero antes del primer registro:

DBSELECTAREA(“SC5”)

MSGALERT( BOF() )                          // Resulta: .F.

DBSKIP( -1 )

MSGALERT( BOF() )                          // Resulta: .T.