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

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

SEE ALSO

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

PTC MKS Toolkit 10.4 Documentation Build 39.