Function: cl-make-hash-table

cl-make-hash-table is a function alias for make-hash-table, defined in fns.c.

This function is obsolete since 24.3; use make-hash-table instead.

Signature

(cl-make-hash-table &rest KEYWORD-ARGS)

Documentation

Create and return a new hash table.

Arguments are specified as keyword/argument pairs. The following arguments are defined:

:test TEST -- TEST must be a symbol that specifies how to compare
keys. Default is eql. Predefined are the tests eq, eql, and equal. User-supplied test and hash functions can be specified via define-hash-table-test.

:size SIZE -- A hint as to how many elements will be put in the table.
The table will always grow as needed; this argument may help performance slightly if the size is known in advance but is never required.

:weakness WEAK -- WEAK must be one of nil, t, key, value,
key-or-value, or key-and-value. If WEAK is not nil, the table returned is a weak table. Key/value pairs are removed from a weak hash table when there are no non-weak references pointing to their key, value, one of key or value, or both key and value, depending on WEAK. WEAK t is equivalent to key-and-value. Default value of WEAK is nil.

:purecopy PURECOPY -- If PURECOPY is non-nil, the table can be copied
to pure storage when Emacs is being dumped, making the contents of the table read only. Any further changes to purified tables will result in an error.

The keywords arguments :rehash-threshold and :rehash-size are obsolete and ignored.

Aliases

cl-make-hash-table (obsolete since 24.3)