Append

Append[expr,elem]

gives expr with elem appended.

Append[elem]

represents an operator form of Append that can be applied to an expression.

Details

  • In iteratively building a list, it is usually more efficient to use Sow and Reap than to use Append[list,new] at each step.
  • Append works on SparseArray objects, returning ordinary lists if necessary.
  • Append can be used on Association objects. Single new elements are specified in the form key->value. New values replace older ones if their keys are the same.
  • Multiple elements to append to an association can be specified in the form {key1->value1,key2->value2, }.
  • Append[elem][expr] is equivalent to Append[expr,elem].

Examples

open allclose all

Basic Examples  (3)

Append to an Association:

Append several rules to an Association:

Generalizations & Extensions  (1)

Use a head other than List:

Applications  (4)

Append a row to a matrix:

Append to each row in a matrix:

Append a vector to a matrix:

Successively append to a list:

Possible Issues  (2)

When working on a shared list in parallel, Append is not atomic (or thread-safe):

Use AppendTo in such circumstances:

Introduced in 1988
 (1.0)
 |
Updated in 2003
 (5.0)
2014
 (10.0)