gethash

(gethash key table &optional default)

table から key を検索し、対応する値を返します。キーがない場合は default (省略時は nil) を返します。キーは equal によるかのように構造的に比較されるため、等しいリスト・文字列・数値のキーが一致します。値を格納するには gethash を setf の場所として使います: (setf (gethash key table) value)。これは incf/decf/push とも連携します。place の key、table、default は左から右に評価され、値はその後に評価されます。書き込みの default は評価されますが格納されません。multiple-value-bind（および他の多値コンシューマ）の下では、gethash 呼び出しは 2 番目の present-p 値も供給し、格納された nil とキーの不在を区別できます。関数オブジェクト #'gethash も同じ省略可能な default を受け取り、同じ 2 つの値を返します。table がハッシュテーブルでなければ、期待型を hash-table とする type-error を通知します: GETHASH: The value 5 is not of type HASH-TABLE。