1.74.2 Send methods

hash_table ->append: key=any, value=any

Append a new association to the table. The first argument is the key; the second is the associated value. If the key was already in the table, associated value is changed.

hash_table ->buckets: int

Set the number of buckets in the table. This method might be useful for two purposes:

• When the number of elements in known in advance, setting the number of buckets avoids rehashing.
• The number of buckets is not minimised if members are deleted or the table is cleared. The hash_table->buckets method may be used to make the table smaller.

  The next legal value (large enough and a power of 2) is used.

hash_table ->clear:

Delete all entries from the table. After hash_table->clear, hash_table<-size equals 0. The number of buckets is not changed.

hash_table ->delete: key=any

Delete association with given key. If there is no such association, hash_table->delete fails.

hash_table ->empty:

Test if hash_table<-size equals 0.

See also

hash_table-size

hash_table ->for_all: action=code, safe=[bool]

Run code on all elements of the table. If code fails for some symbol, this method immediately exists with failure. Arguments:

@arg1:	Key of the symbol
@arg2:	Value of the symbol

Note that the order in which the symbols are presented to the code is not specified.

See also

- chain->for_all
- hash_table->for_some

hash_table ->for_some: action=code, safe=[bool]

Run code on all elements of the table. The return status of code is ignored.

@arg1:	Key of the symbol
@arg2:	Value of the symbol

Note that the order in which the symbols are presented to the code is not specified.

See also

hash_table->for_all

hash_table ->initialise: buckets=[int]

Create a hash_table. The argument is the number of buckets. Note that this will be automatically increased if necessary. Normally it is not specified.

Defaults: 8

hash_table ->unlink:

Clears the table and deallocates the alien symbol array.