Xiqual 0.9.1

HashTable* hash_new

(ulong tag1,
  ... )

Create a fixed-size hash table.

Documentation

Create a fixed-size hash table.

Tags

Like many other Xiqual functions, hash_new() requires a set of tags as its parameters. See the hashtest.c source for an example. The recognised tags are as follows:

• HASH_SIZE

• Number of buckets in the hash table. Multiply by load to find the maximum number of elements normally allowed.

• HASH_LOAD

• Number of elements per bucket. This is only an average, as some buckets might only get one elements, and others get three or more. Load multiplied by size is the hard limit.

• HASH_NODESIZE

• If you require more space in each node, you can extend the existing node structure and specify the new size here. Your new node must start with exactly the same fields as struct HashNode.

Parameters:

tag1 - First tag.

Returns:

A blank hash table of the specified size, or NULL on failure.

Author:

Ronny Bangsund

See Also:

hash_free(), hash_find(), hash_add(), hash_newnode(), HashTable, HashNode

Alphabetic index