Reference for Processing version 1.5. If you have a previous version, use the reference included with your software. If you see any errors or have suggestions, please let us know. If you prefer a more technical reference, visit the Processing Javadoc.

Name

### splice()

Examples

    String[] sa1 = { "OH", "NY", "CA" };
    sa1 = splice(sa1, "KY", 1);
    println(sa1);  // Prints OH, KY, NY, CA
    println();

    String[] sa2 = { "VA", "CO", "IL" };
    sa1 = splice(sa1, sa2, 2);
    println(sa1);  // Prints OH, KY, VA, CO, IL, NY, CA

Description

Inserts a value or array of values into an existing array. The first two parameters must be of the same datatype. The array parameter defines the array which will be modified and the second parameter defines the data which will be inserted.
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[]) splice(array1, array2, index).

Syntax

    splice(array, value, index)
    splice(array, array2, index)

Parameters

array | boolean[], byte[], char[], int[], float[], String[], or an array of objects
value | boolean, byte, char, int, float, String, or other Object: value to be spliced in
array2 | boolean[], byte[], char[], int[], float[], String[], or an array of objects to be spliced in
index | int: position in the array from which to insert data

Returns | Array (the same datatype as the input)
Usage | Web & Application
Related | contract() subset()

Updated on August 30, 2010 04:29:39pm EDT