manual:chapter6:lists:cmd_addrot

Synopsis


Add elements to a list, keeping only the last N elements

Stack Diagram


Input Stack Output Stack
Ldata Oitem Isize Ldata-upd
Level 3 Level 2 Level 1 Level 1

Legend

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

Description


The ADDROT command adds element to a list just like the command ADD does, but with a difference: if the list grows larger than Isize elements, the first one gets removed.

Compatibility


ADDROT is specific to newRPL and has no direct equivalent in userRPL.

Usage


Input

4:                                      
3:                             { A B C }
2:                                     X
1:                                     3
…………………………………………………………………………………………………………
ADDROT                                  


Output

4:                                      
3:                                      
2:                                      
1:                             { B C 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
  • manual/chapter6/lists/cmd_addrot.txt
  • Last modified: 2021/10/03 13:48
  • by jojo1973