Hitachi

インメモリデータグリッド Hitachi Elastic Application Data Store ユーザーズガイド


20.1.24 ead_get_group_key_count()(グループ指定によるkeyの数の取得)

〈この項の構成〉

(1) 機能

指定したグループに属するkeyの数を取得します。指定したグループの下位階層のグループに属するkeyも,取得されるkeyの数に含まれます。

(2) 形式

#include <eads.h>
size_t ead_get_group_key_count
(
  const EAD_CACHE     *cp,            /* In */
  const char          *group_name,    /* In */
  int                 *error_code     /* Out */
);

(3) 引数

cp

keyの数を取得するキャッシュのハンドル(ポインタ)を指定します。

ead_start_cache()で取得したハンドルを指定してください。

group_name

グループ名を指定します。

指定できるデータについては,「15.2.2(2) グループ名として指定できるデータ」を参照してください。

error_code

エラーコード取得先のポインタを指定します。

エラーコードについては,「20.2 クライアントライブラリのエラーコード(C言語)」を参照してください。

(4) 戻り値

指定したグループに属するkeyの数が返却されます。

エラーによってkeyの数の取得に失敗した場合,0が返却されます。