prepend

Add data to the start of an array

Description

prepend a data to the start of an array.

Usage

<stdin> -> prepend: value -> <stdout>

Examples

» a [January..December] -> prepend: 'New Year'
New Year
January
February
March
April
May
June
July
August
September
October
November
December

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

• prepend
• list.prepend

See Also

• [ Index ]: Outputs an element from an array, map or table
• [[ Element ]]: Outputs an element from a nested structure
• a (mkarray): A sophisticated yet simple way to build an array or list
• addheading: Adds headings to a table
• append: Add data to the end of an array
• cast: Alters the data type of the previous function without altering it's output
• count: Count items in a map, list or array
• ja (mkarray): A sophisticated yet simply way to build a JSON array
• match: Match an exact value in an array
• msort: Sorts an array - data type agnostic
• mtac: Reverse the order of an array
• regexp: Regexp tools for arrays / lists of strings

---

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