all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#28876: 26.0; (elisp) `Hash Tables': hash table vs alist
@ 2017-10-17 15:45 Drew Adams
  2019-10-09  8:33 ` Lars Ingebrigtsen
  0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2017-10-17 15:45 UTC (permalink / raw)
  To: 28876

1. Please consider saying explicitly that an Elisp hash table is not a
multimap.

This is another way in which it differs from an alist.  An alist can
have multiple entries that have exactly the same key (even `eq').  An
Elisp hash table cannot - it realizes a mathematical function: one key
gives you only one value.

(The fact that `assoc' and `assq' ignore entries past the first is
irrelevant here.  An alist is a list; it can be used in many ways.)


2. Wrt the difference between an alist and a hash table, the emphasis in
this node seems to be on the performance characteristics.  I think that
functional/structural differences should be distinguished here from
performance differences, instead of just lumping them together in the
same bulleted list.

From the perspective of using a hash table, certainly the performance
(as well as the non-multimap characteristic) is important, and often
decisive.  But from the perspective of using an alist, the structure (as
well as the multimap characteristic) is also important: Lisp programs
manipulate alists as lists - they do not necessarily just use `assoc' or
`assq' on them.

This node seems to have been written by a hash table-only user, not a
general Lisp user, who might use both hash tables and alists.  Please
consider expanding the description of the difference between the two,
which means expanding on what is said about alists.

I recognize that the main purpose of this node is to describe/introduce
hash tables.  But this is Lisp, so I think it is important to _really_
describe how a hash table differs, in its use, from an alist.  An alist
is a more general thingy - you can use it in ways that you cannot use a
hash table.  That BIG difference does not come across in this node, so
far.

In GNU Emacs 26.0.90 (build 3, x86_64-w64-mingw32)
 of 2017-10-13
Repository revision: 906224eba147bdfc0514090064e8e8f53160f1d4
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''





^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#28876: 26.0; (elisp) `Hash Tables': hash table vs alist
  2017-10-17 15:45 bug#28876: 26.0; (elisp) `Hash Tables': hash table vs alist Drew Adams
@ 2019-10-09  8:33 ` Lars Ingebrigtsen
  2019-10-09 14:47   ` Drew Adams
  0 siblings, 1 reply; 3+ messages in thread
From: Lars Ingebrigtsen @ 2019-10-09  8:33 UTC (permalink / raw)
  To: Drew Adams; +Cc: 28876

Drew Adams <drew.adams@oracle.com> writes:

> 1. Please consider saying explicitly that an Elisp hash table is not a
> multimap.
>
> This is another way in which it differs from an alist.  An alist can
> have multiple entries that have exactly the same key (even `eq').  An
> Elisp hash table cannot - it realizes a mathematical function: one key
> gives you only one value.
>
> (The fact that `assoc' and `assq' ignore entries past the first is
> irrelevant here.  An alist is a list; it can be used in many ways.)

An alist is a list that associates keys with value.  There may be
several identical keys in the list, but that is not how an alist is
meant to be used, which is reflected in how the common operators on
alists work -- they only return the first match.

So I don't think this is a difference that needs to be pointed out here.

> 2. Wrt the difference between an alist and a hash table, the emphasis in
> this node seems to be on the performance characteristics.  I think that
> functional/structural differences should be distinguished here from
> performance differences, instead of just lumping them together in the
> same bulleted list.

The primary difference is in the performance characteristics, so I don't
see anything that needs changing in that node.  Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#28876: 26.0; (elisp) `Hash Tables': hash table vs alist
  2019-10-09  8:33 ` Lars Ingebrigtsen
@ 2019-10-09 14:47   ` Drew Adams
  0 siblings, 0 replies; 3+ messages in thread
From: Drew Adams @ 2019-10-09 14:47 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 28876

> > 1. Please consider saying explicitly that an Elisp hash table is not a
> > multimap.
> >
> > This is another way in which it differs from an alist.  An alist can
> > have multiple entries that have exactly the same key (even `eq').  An
> > Elisp hash table cannot - it realizes a mathematical function: one key
> > gives you only one value.
> >
> > (The fact that `assoc' and `assq' ignore entries past the first is
> > irrelevant here.  An alist is a list; it can be used in many ways.)
> 
> An alist is a list that associates keys with value.  There may be
> several identical keys in the list, but that is not how an alist is
> meant to be used, which is reflected in how the common operators on
> alists work -- they only return the first match.

That is _exactly_ how an alist is meant to be used.

And not understanding that is precisely the problem here.

The point of using an alist is that you can, and you
typically will, have multiple entries with the same
key, AND that only the first one is returned by the
specifically-alist access functions.

An alist is not a hash table, and this is one of the
most important differences.

> So I don't think this is a difference that needs to be pointed out here.

That's unfortunate.

> > 2. Wrt the difference between an alist and a hash table, the emphasis in
> > this node seems to be on the performance characteristics.  I think that
> > functional/structural differences should be distinguished here from
> > performance differences, instead of just lumping them together in the
> > same bulleted list.
> 
> The primary difference is in the performance characteristics, so I don't
> see anything that needs changing in that node.

No, the primary difference is not in the performance
characteristics.  And even those can be more complex
that what is presented here.

Users used to other languages too often assume that
an Emacs-Lisp hash table will be more performant than
an alist, at least for a large set.  Things are not
so simple.

The primary difference is structural.  It is especially
that an alist is a Lisp _list_.

> Closing.

That's too bad.





^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2019-10-09 14:47 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-10-17 15:45 bug#28876: 26.0; (elisp) `Hash Tables': hash table vs alist Drew Adams
2019-10-09  8:33 ` Lars Ingebrigtsen
2019-10-09 14:47   ` Drew Adams

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.