append() / Reference / Processing.org

Name

append()

Description

Expands an array by one element and adds data to the new position. The datatype of the element parameter must be the same as the datatype of the array.

When using an array of objects, the data returned from the function must be cast to the object array's data type. For example: SomeClass[] items = (SomeClass[]) append(originalArray, element).

Examples

String[] sa1 = { "OH", "NY", "CA"}; 
String[] sa2 = append(sa1, "MA");
println(sa2);
// Prints updated array contents to the console:
// [0] "OH"
// [1] "NY"
// [2] "CA"
// [3] "MA"

Syntax

append(array, value)

Parameters

array(byte[], char[], int[], float[], String[], Object)array to append
value(byte, char, int, float, String, Object)new data for the array

Return

byte[], char[], int[], float[], String[], or Object

shorten()
expand()

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.