JsArray

DataType(JsArray) = 'object'
ObjectType(JsArray) = 'JsArray'

Объект похожий на массив JavaScript.

Конструктор

Создает пустой массив или массив с элементами:

var arr = new Array;
arr.push('my_item');

или

var arr = [
	'my_item'
];

Свойства

length

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

JsArray.length: number

Методы

indexOf()

Находит первое вхождение элемента с заданным значением и возвращает его порядковый индекс. Если элемент не найден, возвращает -1 (смотреть alert(-1)).

JsArray.indexOf(
	value: any|undefined,
	startIndex: number = 0,
): number

value - Значение, которое необходимо найти.
startIndex - Индекс в массиве, с которого необходимо начинать поиск. По умолчанию поиск ведется с начала массива.

join()

Возвращает строку всех элементов автоматически преобразованных к строке и разделенных указанным разделителем.
Если массив имеет всего один элемент, вернется только этот элемент преобразованный к строке и без разделителя.
Если массив не имеет ни одного элемента, вернется пустая строчка.

JsArray.join(
	separator: string = ',',
): string

separator - Разделитель между элементами. По умолчанию разделяет элементы запятой.

push()

Добавляет элементы в конец массива. Добавляет элементы, начиная с текущей длинны length и возвращает новую, увеличенную длину массива.

JsArray.push(
	...items: any|undefined,
): number

...items - Элементы для вставки. Должен быть указан как минимум один элемент.

splice()

Удаляет часть массива.

JsArray.splice(
	startIndex: number,
	length: number,
): undefined

startIndex - Индекс в массиве, с которого необходимо начинать удаление.
length - Количество элементов, которое нужно удалить, начиная с индекса startIndex.

ByValueExists()

Метод не существует в WebSoft HCM 916 версии.
Проверяет существует ли в массиве элемент с заданным значением.

JsArray.ByValueExists(
	value: any,
): bool

FindIndexBySortedValue()

Находит первое вхождение элемента с заданным значением в отсортированном массиве и возвращает его порядковый индекс. Если элемент не найден, возвращает -1 (смотреть alert(-1)).
За счет того, что массив отсортирован по возрастанию значений, метод работает существенно быстрее, чем indexOf.

JsArray.FindIndexBySortedValue(
	value: any,
): number

ObtainBySortedValue()

Метод не существует в WebSoft HCM 916 версии.
Ищет элемент с заданным значением в отсортированном массиве. Если элемент существует, возвращает индекс найденного элемента. Если нет, добавляет элемент с заданным значением в нужную позицию, так чтобы сохранилась сортировка, и возвращает индекс добавленного элемента.
Метод предполагает, что массив уже отсортирован по значению, что дает малое время поиска и добавления даже для больших массивов. Если массив не отсортирован, результат работы метода не определен.

JsArray.ObtainBySortedValue(
	value: any,
): number