CRecordset::IsBOF

Статья
02/20/2013

Возвращает ненулевое значение, если был расположен набор записей перед первой записью.Отсутствует текущая запись.

BOOL IsBOF( ) const;

Возвращаемое значение

Ненулевой если набор записей не содержит записи или если прокрутили назад до первой записи; в противном случае – значение 0.

Заметки

Эта функция-член вызывается перед прокрутите от записи к записи для изучения шли ли перед первой записью набора записей.Можно также использовать IsBOF вместе с IsEOF чтобы определить, содержит ли набор записей какие-либо записи или пуст.Сразу после вызова Открыть, если набор записей не содержит записи, то IsBOF возвращает ненулевое значение. При открытии набора записей, который содержит хотя бы одну запись, первая запись, возвращают 0 текущей записи и IsBOF.

Если первая запись текущей записи и вызове MovePrev, то IsBOF далее возвращает ненулевое значение.Если IsBOF возвращает ненулевое и вызове MovePrev, возникает ошибка.Если IsBOF возвращает ненулевое, текущая запись не определена, и любое действие, требует текущей записи приведет к ошибке.

Пример

В этом примере используется IsBOF и IsEOF для определения ограничения набора записей как код прокручивает набор записей в обоих направлениях.

// 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();