Array<T>

без пакета

расширяется RegExpMatch

Доступно на всех платформах

Конструктор

new()

Создаёт новый массив.

Переменные

read onlylength:Int

Длина массива this.

Методы

concat(a:Array<T>):Array<T>

Возвращает новый массив, добавляя элементы a к элементам массива this.

Эта операция не изменяет массив this.

Если a является пустым массивом [], возвращается копия массива this.

Длина возвращаемого массива равна сумме this.length и a.length.

Если a является null, результат не определён.

contains(x:T):Bool

Возвращает, содержит ли массив this элемент x.

Если x найден с помощью стандартного сравнения, функция возвращает true, в противном случае – false.

copy():Array<T>

Возвращает поверхностную копию массива this.

Элементы не копируются и сохраняют свою идентичность, поэтому a[i] == a.copy()[i] является истинным для любого допустимого i. Однако a == a.copy() всегда ложно.

inlinefilter(f:T ‑> Bool):Array<T>

Возвращает массив, содержащий элементы массива this, для которых функция f возвращала true.

Отдельные элементы не дублируются и сохраняют свою идентичность.

Если f равно null, результат не определён.

indexOf(x:T, ?fromIndex:Int):Int

Возвращает позицию первого вхождения элемента x в массиве this, ища с начала.

Если x найден с помощью стандартного сравнения, функция возвращает его индекс.

Если x не найден, функция возвращает -1.

Если fromIndex указан, он будет использован в качестве начального индекса поиска, в противном случае поиск начинается с индекса ноль. Если он отрицательный, он будет интерпретироваться как смещение от конца массива this, чтобы вычислить начальный индекс. Если полученный или заданный начальный индекс меньше 0, весь массив будет просмотрен, если он больше или равен длине массива this, функция возвращает -1.

insert(pos:Int, x:T):Void

Вставляет элемент x в позицию pos.

Эта операция изменяет массив this на месте.

Смещение вычисляется следующим образом:

• Если pos превышает this.length, смещение равно this.length.
• Если pos отрицательно, смещение вычисляется от конца массива this, т.е. this.length + pos. Если это даёт отрицательное значение, смещение равно 0.
• В противном случае смещение равно pos.

Если полученное смещение не превышает this.length, все элементы, начиная с этого смещения и до конца массива this, сдвигаются на одну позицию вперёд.

inlineiterator():ArrayIterator<T>

Возвращает итератор значений массива.

join(sep:String):String

Возвращает строковое представление массива this, с разделителем sep между элементами.

Результат этой операции равен Std.string(this[0]) + sep + Std.string(this[1]) + sep + ... + sep + Std.string(this[this.length-1])

Если this является пустым массивом [], результатом является пустая строка "". Если this содержит ровно один элемент, результат равен вызову Std.string(this[0]).

Если sep равно null, результат не определён.

inlinekeyValueIterator():ArrayKeyValueIterator<T>

Возвращает итератор индексов и значений массива.

lastIndexOf(x:T, ?fromIndex:Int):Int

Возвращает позицию последнего вхождения элемента x в массиве this, ища с конца.

Если x найден с помощью стандартного сравнения, функция возвращает его индекс.

Если x не найден, функция возвращает -1.

Если fromIndex указан, он будет использован в качестве начального индекса поиска, в противном случае поиск начинается с последнего индекса. Если он отрицательный, он будет интерпретироваться как смещение от конца массива this, чтобы вычислить начальный индекс. Если полученный или заданный начальный индекс больше или равен длине массива this, весь массив будет просмотрен, если он меньше 0, функция возвращает -1.

inlinemap<S>(f:T ‑> S):Array<S>

Создаёт новый массив, применяя функцию f ко всем элементам массива this.

Порядок элементов сохраняется.

Если f равно null, результат не определён.

pop():Null<T>

Удаляет последний элемент из массива this и возвращает его.

Эта операция изменяет массив this на месте.

Если this содержит хотя бы один элемент, this.length уменьшается на 1.

Если this является пустым массивом [], возвращается null, и длина остаётся 0.

push(x:T):Int

Добавляет элемент x в конец массива this и возвращает новую длину массива this.

Эта операция изменяет массив this на месте.

this.length увеличивается на 1.

remove(x:T):Bool

Удаляет первое вхождение элемента x из массива this.

Эта операция изменяет массив this на месте.

Если x найден с помощью стандартного сравнения, он удаляется из массива this и все последующие элементы переиндексируются. Функция затем возвращает true.

Если x не найден, массив this не изменяется, и функция возвращает false.

resize(len:Int):Void

Устанавливает длину массива.

Если новая длина массива короче текущей, последние length - len элементов будут удалены. Если новая длина длиннее, массив будет расширен, а новые элементы будут установлены в значение по умолчанию, специфичное для типа:

• всегда null для динамических целей
• 0, 0.0 или false соответственно для Int, Float и Bool для статических целей
• null для других типов для статических целей

reverse():Void

Обращает порядок элементов массива this.

Эта операция изменяет массив this на месте.

Если this.length < 2, this остаётся без изменений.

shift():Null<T>

Удаляет первый элемент из массива this и возвращает его.

Эта операция изменяет массив this на месте.

Если this содержит хотя бы один элемент, длина массива this и индекс каждого оставшегося элемента уменьшаются на 1.

Если this является пустым массивом [], возвращается null, и длина остаётся 0.

slice(pos:Int, ?end:Int):Array<T>

Создаёт поверхностную копию диапазона массива this, начиная с элемента pos (включительно) до элемента end (не включая).

Эта операция не изменяет массив this.

Элементы не копируются и сохраняют свою идентичность.

Если end опущено или превышает this.length, оно по умолчанию устанавливается в конец массива this.

Если pos или end отрицательны, их смещения вычисляются от конца массива this соответственно по this.length + pos и this.length + end. Если это даёт отрицательное значение, используется 0.

Если pos превышает this.length или если end меньше или равно pos, результатом является [].

sort(f:(T, T) ‑> Int):Void

Сортирует массив this в соответствии с функцией сравнения f, где f(x,y) возвращает 0, если x == y, положительное целое число, если x > y, и отрицательное целое число, если x < y.

Эта операция изменяет массив this на месте.

Операция сортировки не гарантирует стабильности, что означает, что порядок одинаковых элементов может быть изменён. Для стабильного алгоритма сортировки массивов вместо haxe.ds.ArraySort.sort() можно использовать haxe.ds.ArraySort.sort().

Если f равно null, результат не определён.

splice(pos:Int, len:Int):Array<T>

Удаляет len элементов из массива this, начиная с элемента pos (включительно), и возвращает их.

Эта операция изменяет массив this на месте.

Если len меньше 0 или pos превышает длину массива this, возвращается пустой массив [], а массив this не изменяется.

Если pos отрицательно, его значение вычисляется от конца массива this по this.length + pos. Если это даёт отрицательное значение, используется 0.

Если сумма полученных значений для len и pos превышает this.length, эта операция затронет элементы с pos до конца массива this.

Длина возвращаемого массива равна разности между новой длиной массива this и исходной длиной массива this. Другими словами, каждый элемент исходного массива this либо остаётся в массиве this, либо становится элементом возвращаемого массива.

toString():String

Возвращает строковое представление массива this.

Результат будет содержать строковые представления отдельных элементов, разделённые запятыми. Заключающие [ ] могут отсутствовать на некоторых платформах. Используйте Std.string() для получения строкового представления, согласованного на всех платформах.

unshift(x:T):Void

Добавляет элемент x в начало массива this.

Данная операция изменяет массив this на месте.

this.length и индекс каждого элемента массива увеличивается на 1.