22.1.11 ead_get()(valueの取得)
(1) 機能
指定したkeyに関連づけられたvalueを取得します。
(2) 形式
#include <eads.h> ead_value_element ead_get ( const EAD_CACHE *cp, /* In */ const char *key, /* In */ int *error_code /* Out */ );
(3) 引数
- cp
-
取得するvalueが格納されているキャッシュのハンドル(ポインタ)を指定します。
ead_start_cache()で取得したハンドルを指定してください。
- key
-
取得するvalueに関連づけられたkeyを指定します。
指定できるデータについては,「15.2.2(1) keyとして指定できるデータ」を参照してください。
- error_code
-
エラーコード取得先のポインタを指定します。
エラーコードについては,「22.2 クライアントライブラリのエラーコード(C言語)」を参照してください。
(4) 戻り値
keyに関連づけられたvalue情報(ead_value_element構造体)が返却されます。
ead_value_element構造体の形式と説明については,「22.1.20 ead_value_element構造体(value情報)」を参照してください。
次の場合は,ead_value_element構造体のvalueメンバにNULLが設定されます。
-
keyがキャッシュに存在しない場合
-
value情報の取得で問題が発生した場合
-
valueのデータサイズが0バイトの場合(Java言語のAPIで格納された,長さ0のバイト配列を取得した場合)
(5) 注意事項
戻り値として返却されたvalue情報のメモリ領域は,自動的に解放されないため,APで解放してください。