Доступ к хеш-таблице

В данном разделе описаны функции для доступа и хранения ассоциаций в хеш-таблице. В общем случае, любой объект Lisp может быть использован в качестве ключа хеш-таблицы, если метод сравнения не накладывает ограничений. Любой объект Lisp также может быть использован в качестве значения.

Функция: gethash ключ таблица &опционально значение_по_умолчанию

Эта функция ищет ключ в таблице и возвращает его связанное значение — или значение_по_умолчанию, если ключ не имеет ассоциации в таблице.

Функция: puthash ключ значение таблица

Эта функция добавляет ассоциацию для ключа в таблице со значением значение. Если ключ уже имеет ассоциацию в таблице, значение заменяет старое связанное значение. Эта функция всегда возвращает значение.

Функция: remhash ключ таблица

Эта функция удаляет ассоциацию для ключа из таблицы, если она существует. Если ключ не имеет ассоциации, remhash ничего не делает.

Примечание Common Lisp: В Common Lisp, remhash возвращает не-nil, если она фактически удалила ассоциацию, и nil в противном случае. В Emacs Lisp, remhash всегда возвращает nil.

Функция: clrhash таблица

Эта функция удаляет все ассоциации из хеш-таблицы таблица, так что она становится пустой. Это также называется *очисткой* хеш-таблицы. clrhash возвращает пустую таблицу.

Функция: maphash функция таблица

Эта функция вызывает функцию один раз для каждой из ассоциаций в таблице. Функция функция должна принимать два аргумента — ключ из таблицы и его связанное значение. maphash возвращает nil.