User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

cl:functions:values-list [2019/09/14 05:00]
cl:functions:values-list [2019/09/22 06:00] (current)
Line 1: Line 1:
 +====== Function VALUES-LIST ======
 +
 +====Syntax====
 +  * values-list //list// → //​element''​*''//​
 +
 +====Arguments and Values====
 +  * //list// - a //​[[CL:​Glossary:​list]]//​.
 +  * //​elements//​ - the //​[[CL:​Glossary:​element|elements]]//​ of the //list//.
 +
 +====Description====
 +Returns the //​[[CL:​Glossary:​element|elements]]//​ of the //list// as //​[[CL:​Glossary:​multiple values]]//.
 +
 +====Examples====
 +<​blockquote>​
 +(values-list nil) <​r>//<​no values>//</​r>​
 +(values-list '(1)) <​r>​1</​r>​
 +(values-list '(1 2)) <r>1
 +2</r>
 +(values-list '(1 2 3)) <r>1
 +2
 +3</r>
 +</​blockquote>​
 +
 +====Affected By====
 +None.
 +
 +====Exceptional Situations====
 +Should signal **[[CL:​Types:​type-error]]** if its argument is not a //​[[CL:​Glossary:​proper list]]//.
 +
 +====See Also====
 +  * **[[CL:​Macros:​multiple-value-bind|Macro MULTIPLE-VALUE-BIND]]**
 +  * **[[CL:​Functions:​multiple-value-list|Function MULTIPLE-VALUE-LIST]]**
 +  * **[[CL:​Constant Variables:​multiple-values-limit|Constant Variable MULTIPLE-VALUES-LIMIT]]**
 +  * **[[CL:​Functions:​values|Function VALUES]]**
 +
 +====Notes====
 +<​blockquote>​
 +(values-list //list//) ≡ ([[CL:​Functions:​apply]] #'​[[CL:​Functions:​values]] //list//)
 +</​blockquote>​
 +
 +''​([[CL:​Functions:​equal]] //x// ([[CL:​Macros:​multiple-value-list]] (values-list //​x//​)))''​ returns //​[[CL:​Glossary:​true]]//​ for all //​[[CL:​Glossary:​lists]]//​ //x//.
 +