manual:chapter6:lists:cmd_tolist [newRPL User Manual]

Synopsis

Assemble a list from its elements

Stack Diagram

Input Stack					Output Stack
O_n	…	O₁	I_n	→	L
Level n+1	…	Level 2	Level 1	→	Level 1

Legend

Legend	Object type
O	Any object
I	Integer number
R	Real number
#	Binary number
Num	Scalar (Integer, Real or Binary number)
Z	Complex number
U	Unit
∡	Angle
A	Symbolic expression
C	Symbolic constant
V	Vector
M	Matrix
S	String
1/0	Any expression evaluating to True or False
G	Grob
F	Font
D	Binary data container
T	Tag object
L	List
cL	Case list
N	Variable name / Identifier
Dir	Directory
pDir	Packed Directory
P	Program
Lib	Library

Keyword type	Command
Parallel list processing capabilities	Group 2	Commands that must use `DOLIST` to parallel process
Affected by flags	None

Description

The →LIST command combines the first I_n elements on the stack above itself in a list.

Compatibility

→LIST is fully equivalent to its userRPL counterpart.

Usage

Input

4:                                 '3/8'
3:                    "This is a string"
2:                              'SIN(X)'
1:                                     2
…………………………………………………………………………………………………………
→LIST

Output

4:                                      
3:                                      
2:                                 '3/8'
1:       { "This is a string" 'SIN(X)' }
…………………………………………………………………………………………………………

Related Commands

Operations with Lists 15 2 NEW

Command	Short Description
→LIST	Assemble a list from its elements
LIST→	Split a list into its elements
DOLIST	Do a procedure with elements of lists	CHANGED
DOSUBS	Do a procedure on a subset of a list	CHANGED
MAP	Do a procedure on each element of a list, recursively
MAPLIST→	Do a procedure on each element recursively, return individual elements	NEW
STREAM	Do a procedure on consecutive elements of a list
ΔLIST	First differences on the elements of a list
ΣLIST	Sum of all elements in a list	CHANGED
ΠLIST	Product of all elements in a list	CHANGED
ADD	Concatenate lists and/or elements	CHANGED
SORT	Sort elements in a list
REVLIST	Reverse the order of elements in a list
ADDROT	Add elements to a list, keep only the last N elements	NEW
SEQ	Assemble a list from results of sequential procedure