IsNullメソッド

機能

IN/OUT,OUTパラメタの値がNULL(欠損値)かどうかを確認します。

形式

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

BOOLEAN  IsNull(UINT32 dwIndex) throw DBSQLCA

パラメタ名で指定する場合

BOOLEAN  IsNull(LPCTSTR lpctName) throw DBSQLCA

引数

dwIndex

1から始まるIN/OUT,OUTパラメタの番号を指定します。

lpctName

プロシジャ作成時に指定したパラメタ名を指定します。

戻り値

データ型:BOOLEAN

TRUE:IN/OUT,OUTパラメタの値がNULLです。

FALSE:IN/OUT,OUTパラメタの値はNULLではありません。

機能詳細

指定されたIN/OUT,OUTパラメタがNULLかどうかを確認します。

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

NULLであるIN/OUT,OUTパラメタに対してGetParamメソッドを呼び出すと,戻される値は意味のない値(0,NULL文字列,要素がすべて0,NULL文字列からなる構造体,又は不定値)となります。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。
DB_ERROR_PROCEDURE_NOT_COMPLETE
プロシジャが完了していません。
DB_ERROR_RESULTSET_NOT_EXIST
非同期実行時に,検索結果がまだ取得できていません。
DB_ERROR_ARGUMENT_OUT_OF_RANGE
引数dwIndexの範囲が不正です。
DB_ERROR_CANNOT_BE_NULL
引数lpctNameにNULLを指定しています。
DB_DRV_ERROR_INVALID_ARGUMENT
引数に指定したパラメタ名,パラメタ番号は不正です。