CRecordset::IsBOF

BOOL IsBOF( ) const;

返回值:
如果记录集不包含记录或者程序已经向后滚动到第一个记录之前,则返回一个非零值;否则返回值为0。

说明:
在记录之间滚动之前调用这个函数,以确定是否已经到了记录集的第一条记录之前。你也可以与IsEOF一起使用IsBOF函数来确定记录集中是否包含记录,或者为空。在调用Open之后,如果记录集不包含记录,IsBOF返回非零值。当你打开一个至少具有一条记录的记录集时,第一个记录成为当前记录,IsBOF返回0。
如果当前记录为第一条记录并且你调用了MovePrev,IsBOF将随后返回一个非零值。如果IsBOF返回非零值并且你调用了MovePrev,将会发生错误。如果IsBOF返回非零值,则当前记录没有定义,所有需要当前记录的操作将会导致错误。

示例:
这个例子在双向滚动记录集时使用IsBOF和IsEOF来检测记录集的界限。
// 打开一个记录集,第一条记录是当前记录。
CCustSet rsCustSet( NULL );
rsCustSet.Open( );
if( rsCustSet.IsBOF( ) ) return; // 记录集为空。
// 滚动到记录集的尾部,越过最后一条记录,因此没有当前记录。

while ( !rsCustSet.IsEOF( ) ) rsCustSet.MoveNext( ); // 移动到最后一条记录
rsCustSet.MoveLast( );
// 滚动到记录集的头部,在第一条记录之前,因此没有当前记录。

while( !rsCustSet.IsBOF( ) ) rsCustSet.MovePrev( ); // 第一条记录又成了当前记录。
rsCustSet.MoveFirst( );

请参阅:
CRecordset::IsEOF, CRecordset::MoveFirst, CRecordset::MovePrev