values-list (ANSI and GNU Common Lisp Document)

Next: multiple-values-limit, Previous: values, Up: Data and Control Flow Dictionary

#### 5.3.54 values-list [Function]

`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

#### 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.