Append

Table of Contents USAGE DESCRIPTION ARGUMENTS REFINEMENTS SOURCE

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!]
] ]