CRecordset::IsEOF

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

レコードセットが最終レコードより後ろに位置付けられているときは 0 以外を返します。現在のレコードはありません。

BOOL IsEOF( ) const;

戻り値

レコードセットにレコードが存在しない場合、または最終レコードより後にスクロールした場合は 0 以外の値を返します。それ以外の場合は 0 を返します。

解説

レコードからレコードにスクロールするときに、レコードセットの最終レコードを越えているかどうかを調べます。IsEOF を使って、レコードセットにレコードが存在するかどうかを調べることもできます。Open 関数を呼び出したすぐ後に、レコードセットにレコードが存在していない場合、IsEOF 関数は 0 以外の値を返します。開いたレコードセットに少なくとも 1 つのレコードあると、最初のレコードが現在のレコードになり、IsEOF は 0 を返します。

最終レコードが現在のレコードの場合に、MoveNext 関数が呼び出されると、IsEOF 関数は 0 以外の値を返します。IsEOF 関数が 0 以外を返した後にさらに MoveNext 関数を呼び出すとエラーが発生します。IsEOF 関数が 0 以外を返したときは、現在のレコードは未定義になり、現在のレコードへの操作はすべてエラーになります。