CRecordset::IsBOF

Artículo
06/10/2015

Devuelve cero si se ha colocado el conjunto de registros antes del primer registro. No hay ningún registro actual.

BOOL IsBOF( ) const;

Valor devuelto

Distinto de cero si el conjunto de registros no contiene ningún registro o si se ha desplazado hacia atrás antes del primer registro; si no 0.

Comentarios

Llame a esta función miembro antes de desplazarse entre registros para saber si ha salido antes del primer registro de conjunto de registros. También puede utilizar IsBOF junto con IsEOF para determinar si el conjunto de registros contiene algún registro o está vacío. Inmediatamente después de llamar a Abrir, si el conjunto de registros no contiene ningún registro, IsBOF devuelve cero. Al abrir un conjunto de registros que contiene por lo menos un registro, el primer registro es el registro actual y IsBOF devuelve 0.

Si el primer registro es el registro actual y se llama a MovePrev, IsBOF devolverá posteriormente distinto de cero. Si IsBOF devuelve cero y llama a MovePrev, se produce un error. Si IsBOF devuelve cero, el registro actual es indefinido, y cualquier acción que requiere un registro actual dará como resultado un error.

Ejemplo

Este ejemplo utiliza IsBOF y IsEOF para detectar los límites de un conjunto de registros mientras el código pasa a través del conjunto de registros en ambas direcciones.

// Open a recordset; first record is current
CCustomer rsCustSet(&m_dbCust);
rsCustSet.Open();

if(rsCustSet.IsBOF())
   return;
   // The recordset is empty 

// Scroll to the end of the recordset, past 
// the last record, so no record is current 
while (!rsCustSet.IsEOF())
   rsCustSet.MoveNext();

// Move to the last record
rsCustSet.MoveLast();

// Scroll to beginning of the recordset, before 
// the first record, so no record is current 
while(!rsCustSet.IsBOF())
   rsCustSet.MovePrev();

// First record is current again
rsCustSet.MoveFirst();