Common Lisp functions can return zero or more results. Emacs Lisp
functions, by contrast, always return exactly one result. This
package makes no attempt to emulate Common Lisp multiple return
values; Emacs versions of Common Lisp functions that return more
than one value either return just the first value (as in
cl-compiler-macroexpand) or return a list of values.
This package does define placeholders
for the Common Lisp functions that work with multiple values, but
in Emacs Lisp these functions simply operate on lists instead.
cl-values form, for example, is a synonym for
This form evaluates values-form, which must return a list of
values. It then binds the vars to these respective values,
as if by
let, and then executes the body forms.
If there are more vars than values, the extra vars
are bound to
nil. If there are fewer vars than
values, the excess values are ignored.
This form evaluates form, which must return a list of values.
It then sets the vars to these respective values, as if by
setq. Extra vars or values are treated the same as
Since a perfect emulation is not feasible in Emacs Lisp, this package opts to keep it as simple and predictable as possible.