IsNullメソッド

機能

フィールドの値がNULLかどうかを確認します。

形式

インデクス番号で指定する場合

BOOLEAN  IsNull(UINT32   dwIndex) throw DBSQLCA

フィールド名称で指定する場合

BOOLEAN  IsNull(LPCTSTR lpctName) throw DBSQLCA

引数

dwIndex

1から始まるフィールドの番号を指定します。

lpctName

フィールド名を指定します。

戻り値

データ型:BOOLEAN

TRUE:フィールドの値がNULLです。

FALSE:フィールドの値はNULLではありません。

機能詳細

指定されたフィールドの値がNULL値かどうかを確認します。

NULLはC言語で使用するNULLポインタの意味ではなく,データベースシステムでは「値がない」ことを意味します。

NULLであるフィールドに対してGetFieldメソッドを呼び出すと,戻される値は意味のない値(0,NULL文字列,要素がすべて0,NULL文字列からなる構造体,又は不定値)となるため注意してください。

SQL/Kの場合,データが設定されていない列を検索しても,IsNullメソッドの戻り値は常にFALSEです。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。
DB_ERROR_RESULTSET_NOT_EXIST
非同期実行時に,検索結果がまだ取得できていません。
DB_ERROR_NOT_FOUND
引数dwIndexの範囲が不正です。
DB_ERROR_CANNOT_BE_NULL
引数lpctNameにNULLを指定しています。
DB_DRV_ERROR_INVALID_ARGUMENT
引数に指定したフィールド名は不正です。