CDaoRecordset::IsFieldNull

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

更新 : 2007 年 11 月

レコードセットの指定したフィールドデータメンバが NULL かどうかを調べます。

BOOL IsFieldNull(
   void* pv 
);

パラメータ

pv
状態を調べるフィールドデータメンバへのポインタ。NULL のフィールドがあるかどうかを調べるには NULL を指定します。

戻り値

指定されたフィールドデータメンバが NULL の場合は 0 以外の値を返します。それ以外の場合は 0 を返します。

解説

(C++ での NULL とは異なり、データベースの専門用語では、NULL は "値を持たない" ことを意味します。)フィールドデータメンバが NULL の場合は、現在のレコードの列には値がないと解釈されます。

メモ :
次のコードで示されているように、IsFieldNull の使用が効果的ではない場合もあります。

COleVariant varValue;
void* pField = &(rs.m_Age);
int nField = 2;

// this code is inefficient because data
// must be retrieved for both IsFieldNull
// and GetFieldValue
if (!rs.IsFieldNull(pField))
   rs.GetFieldValue(nField, varValue);

// this code is more efficient
rs.GetFieldValue(nField, varValue);
if (varValue.vt == VT_NULL)
   varValue.Attach(varNewVal);// do something

メモ :
CDaoRecordset からクラスを派生せずに、ダイナミックレコード連結を使用する場合は、例のように VT_NULL を使用します。