CLHS: Function VALUES-LIST

#

Function VALUES-LIST

Syntax:

values-list list => element*

Arguments and Values:

list---a list.

elements---the elements of the list.

Description:

Returns the elements of the list as multiple values[2].

Examples:

     (values-list nil) =>  <no values>
     (values-list '(1)) =>  1
     (values-list '(1 2)) =>  1, 2
     (values-list '(1 2 3)) =>  1, 2, 3

Affected By: None.

Exceptional Situations:

Should signal type-error if its argument is not a proper list.

See Also:

multiple-value-bind, multiple-value-list, multiple-values-limit, values

Notes:

     (values-list list) ==  (apply #'values list)

`(equal` x`(multiple-value-list (values-list` x`)))` returns true for all lists x.

Copyright 1996-2005, LispWorks Ltd. All rights reserved.