hcreate()

allocate space for hash table 

Function

SYNOPSIS

#include <search.h>

int hcreate(size_t nel);

DESCRIPTION

The hcreate() function allocates space for a hash table sufficient to hold nel elements. This function must be called before hsearch() is called.

PARAMETERS

nel 

Is an estimate of the maximum number of elements that are to be inserted into the table.

RETURN VALUES

The hcreate() function returns 0 if it cannot allocate sufficient space for the table, and returns non-zero otherwise.

CONFORMANCE

UNIX 98.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

Note that only one hash table can be active in a process at any given time.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
bsearch(), hdestroy(), hsearch(), lsearch(), tsearch()

MKS Toolkit 9.2 Documentation Build 16.