Append

angerangel edited this page Dec 14, 2012 · 2 revisions
Clone this wiki locally

Table of Contents

USAGE

  APPEND series value /part length /only /dup count

DESCRIPTION

Inserts element(s) at tail; for series, returns head. APPEND is an action value.

ARGUMENTS

  • series -- Any position (modified) (series! port! map! gob! object! bitset!)
  • value -- The value to insert (any-type!)

REFINEMENTS

  • /part -- Limits to a given length or position
    • length (number! series! pair!)
  • /only -- Only insert a block as a single value (not the contents of the block)
  • /dup -- Duplicates the insert a specified number of times
    • count (number! pair!)

SOURCE

append: make action! [  [
    {Inserts element(s) at tail; for series, returns head.}
    series [series! port! map! gob! object! bitset!] "Any position (modified)"
    value [any-type!] "The value to insert"
    /part "Limits to a given length or position"
    length [number! series! pair!]
    /only {Only insert a block as a single value (not the contents of the block)}
    /dup "Duplicates the insert a specified number of times"
    count [number! pair!]
] ]