mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-06 08:54:05 +00:00
Code Issues Releases Activity

(Creating Hash): Clarify description of eql'. makehash' is obsolete.

Browse Source 
(Hash Access): Add Common Lisp notes for `remhash' and `clrhash'.
This commit is contained in:
Luc Teirlinck 2003-11-09 04:44:28 +00:00
parent bb3612ec1f
commit b02495f1b5
1 changed files with 13 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
lispref/hash.texi
View File

@ -76,8 +76,9 @@ alternatives:
@table @code
@item eql
Keys which are numbers are ``the same'' if they are equal in value;
otherwise, two distinct objects are never ``the same''.
Keys which are numbers are ``the same'' if they are @code{equal}, that
is, if they are equal in value and either both are integers or both
are floats; otherwise, two distinct objects are never ``the same''.
@item eq
Any two distinct Lisp objects are ``different'' as keys.
@ -158,8 +159,7 @@ This is equivalent to @code{make-hash-table}, but with a different style
argument list. The argument @var{test} specifies the method
of key lookup.
If you want to specify other parameters, you should use
@code{make-hash-table}.
This function is obsolete. Use @code{make-hash-table} instead.
@end defun
@node Hash Access
@ -187,6 +187,10 @@ value @var{value}. If @var{key} already has an association in
This function removes the association for @var{key} from @var{table}, if
there is one. If @var{key} has no association, @code{remhash} does
nothing.
@b{Common Lisp note:} In Common Lisp, @code{remhash} returns
non-@code{nil} if it actually removed an association and @code{nil}
otherwise. In Emacs Lisp, @code{remhash} always returns @code{nil}.
@end defun
@tindex clrhash
@ -194,6 +198,9 @@ nothing.
This function removes all the associations from hash table @var{table},
so that it becomes empty. This is also called @dfn{clearing} the hash
table.
@b{Common Lisp note:} In Common Lisp, @code{clrhash} returns the empty
@var{table}. In Emacs Lisp, it returns @code{nil}.
@end defun
@tindex maphash
@ -255,8 +262,8 @@ If two objects @var{obj1} and @var{obj2} are equal, then @code{(sxhash
@var{obj1})} and @code{(sxhash @var{obj2})} are the same integer.
If the two objects are not equal, the values returned by @code{sxhash}
are usually different, but not always; but once in a rare while, by
luck, you will encounter two distinct-looking objects that give the same
are usually different, but not always; once in a rare while, by luck,
you will encounter two distinct-looking objects that give the same
result from @code{sxhash}.
@end defun