hcreate() - ハッシュ検索テーブルの作成

標準

標準/拡張機能	C/C++	依存項目
XPG4 XPG4.2 Single UNIX Specification、バージョン 3	両方

形式

#define _XOPEN_SOURCE
#include <search.h>

int hcreate(size_t nel);

機能説明

hcreate() 関数は、nel エレメントを含むハッシュ・テーブル用に、十分なスペースを割り振ります。hsearch() が使用される前に呼び出す必要があります。

nel 引数は、テーブルが含むエントリーの最大数の概算値です。この数は、ある数学的に好ましい環境を得るために、実際のテーブル割り振りに対して、hcreate() によって上方に調整されます。

スレッド化の動作: hsearch() - ハッシュ・テーブルの検索を参照してください。

戻り値

正常に実行された場合は、hcreate() はゼロ以外を戻します。

hcreate() がテーブルに十分なスペースが割り振ることができない場合、hcreate() は 0 を戻して、errno を次のいずれかの値に設定します。

エラー・コード: 説明
ENOMEM: 使用可能なストレージ・スペースが不十分です。

関連情報