Function values-list

Syntax:

Arguments and Values:

list—a list.

elements—the elements of the list.

Description:

7.9.1 9Returns the elements of the list as multiple values₂.

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.

KMP: Isn't there also some issue to do with max number of values? Moon: No different than in VALUES if (> CALL-ARGUMENTS-LIMIT MULTIPLE-VALUES-LIMIT).

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.