append.md

Append To List (append)

Add data to the end of an array

Description

append data to the end of an array.

Usage

<stdin> -> append value -> <stdout>

Examples

» a [Monday..Sunday] -> append Funday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
Funday

Detail

prepend and append are data type aware:

» tout json [1,2,3] -> append 4 5 6 bob
Error in `append` (1,22): cannot convert 'bob' to a floating point number: strconv.ParseFloat: parsing "bob": invalid syntax

Synonyms

• append
• list.append

See Also

• Add Heading (addheading): Adds headings to a table
• Count (count): Count items in a map, list or array
• Create JSON Array (ja): A sophisticated yet simply way to build a JSON array
• Define Type (cast): Alters the data-type of the previous function without altering its output
• Filter By Range [ ..Range ]: Outputs a ranged subset of data from stdin
• Get Item ([ Index ]): Outputs an element from an array, map or table
• Get Item ([ Index ]): Outputs an element from an array, map or table
• Get Nested Element ([[ Element ]]): Outputs an element from a nested structure
• Match String (match): Match an exact value in an array
• Prepend To List (prepend): Add data to the start of an array
• Regex Operations (regexp): Regexp tools for arrays / lists of strings
• Reverse Array (mtac): Reverse the order of an array
• Sort Array (msort): Sorts an array - data type agnostic
• Stream New List (a): A sophisticated yet simple way to stream an array or list (mkarray)

---

This document was generated from builtins/core/lists/append_doc.yaml.