/* For the given hash TABLE, check the user supplied tuning structure for
reasonable values, and return true if there is no gross error with it.
- Otherwise, definitvely reset the TUNING field to some acceptable default in
- the hash table (that is, the user loses the right of further modifying
+ Otherwise, definitively reset the TUNING field to some acceptable default
+ in the hash table (that is, the user loses the right of further modifying
tuning arguments), and return false. */
static bool
return false;
}
-/* Allocate and return a new hash table, or NULL upon failure. The
- initial number of buckets is automatically selected so as to _guarantee_ that
- you may insert at least CANDIDATE different user entries before any growth
- of the hash table size occurs. So, if have a reasonably tight a-priori
- upper bound on the
- number of entries you intend to insert in the hash table, you may save some
- table memory and insertion time, by specifying it here. If the
- IS_N_BUCKETS field of the TUNING structure is true, the CANDIDATE argument
- has its meaning changed to the wanted number of buckets.
+/* Allocate and return a new hash table, or NULL upon failure. The initial
+ number of buckets is automatically selected so as to _guarantee_ that you
+ may insert at least CANDIDATE different user entries before any growth of
+ the hash table size occurs. So, if have a reasonably tight a-priori upper
+ bound on the number of entries you intend to insert in the hash table, you
+ may save some table memory and insertion time, by specifying it here. If
+ the IS_N_BUCKETS field of the TUNING structure is true, the CANDIDATE
+ argument has its meaning changed to the wanted number of buckets.
TUNING points to a structure of user-supplied values, in case some fine
tuning is wanted over the default behavior of the hasher. If TUNING is
/* For an already existing hash table, change the number of buckets through
specifying CANDIDATE. The contents of the hash table are preserved. The
- new number of buckets is automatically selected so as to _guarantee_ that the
- table may receive at least CANDIDATE different user entries, including
+ new number of buckets is automatically selected so as to _guarantee_ that
+ the table may receive at least CANDIDATE different user entries, including
those already in the table, before any other growth of the hash table size
occurs. If TUNING->IS_N_BUCKETS is true, then CANDIDATE specifies the
exact number of buckets desired. */