Processing:Справочник языка Processing/splice()

Содержание

Среда разработки Processing

Справочник языка Processing

Библиотеки

Примеры

Режимы программирования

Перевод: Максим Кузьмин

Проверка/Оформление/Редактирование: Мякишев Е.А.

splice()

Обозначение

splice()

Описание

Вставляет в массив одно значение или массив значений, не перезаписывая существующие данные. Первые два параметра должны быть массивами (второй параметр также может быть значением) с данными одного и того же типа. Первый параметр (list) задает массив, который будет модифицирован, а второй (value) – данные, которые нужно вставить. Третий параметр (index) – это индекс, который определяет стартовую позицию в массиве, с которой будут вставляться данные. Помните, что самый первый индекс в массиве – это 0, второй – это 1 и т.д. Если вы имеете дело с массивом объектов, то данные, возвращаемые этим методом, должны быть встроены в массив объектов того же типа. Например: SomeClass[] items = (SomeClass[]) splice(array1, array2, index).

Синтаксис

splice(list, value, index)

Параметры

list  – массив, в который нужно вставить данные. Тип данных – Object, String[], float[], int[], char[], byte[] или boolean[]
value – значение или массив, которые нужно вставить. Тип данных – Object, String[], String, float[], float, int[], int, char[], char, byte[], byte, boolean[] или Boolean
index – позиция, с которой новые данные будут вставляться в массив. Тип данных – int

Возвращаемое значение

Тип данных – Object, String[], float[], int[], char[], byte[] или boolean[].

Пример

String[] a = { "OH", "NY", "CA" };
a = splice(a, "KY", 1);  //  вставляет одно значение в массив
println(a);
// напечатает в консоль содержание массива,
// в который было вставлено новое значение:
// [0] "OH"
// [1] "KY"
// [2] "NY"
// [3] "CA"

println();  // напечатает пустую линию

String[] b = { "VA", "CO", "IL" };
a = splice(a, b, 2);  // вставляет один массив в другой
println(a);
// напечатает содержание массива, 
// в который был вставлен другой массив:
// [0] "OH"
// [1] "KY"
// [2] "VA"
// [3] "CO"
// [4] "IL"
// [5] "NY"
// [6] "CA"