Таблица — это тип переменной, представляющий собой массив данных — строк таблицы.
Каждая строка является отдельным элементом массива и представляет собой объект,
свойства которого определены столбцами таблицы.
Свойство TTable.length возвращает число элементов таблицы.
Значение данного свойства — 32-битное беззнаковое целое число, которое всегда больше, чем наибольший индекс в массиве.
Readonly
result
result:R
Строка вычисляемого результата в таблице.
В этой строке могут быть настроены вычисления суммы, среднего, количества.
Methods
concat
concat(...items: (T | ConcatArray<T>)[]): T[]
Метод возвращает новый массив, состоящий из массива элементов таблицы, соединённого с другими массивами и/или значениями, переданными в качестве аргументов.
Внимание: возвращаемое значение — это обычный массив, который не является таблицей.
Parameters
Rest...items: (T | ConcatArray<T>)[]
Returns T[]
Новый массив, содержащий все элементы.
delete
delete(index: number): void
Метод удаляет конкретную строку из заданной таблицы.
Новый массив с элементами, которые прошли проверку.
Если ни один элемент не прошёл проверку, то будет возвращён пустой массив.
find
find(predicate: function, thisArg?: any): T | undefined
Метод возвращает значение первого найденного в таблице элемента, которое удовлетворяет условию, переданному в функции predicate. В противном случае возвращается undefined.
indexOf(searchElement: T, fromIndex?: undefined | number): number
Метод возвращает первый индекс, по которому данный элемент может быть найден в таблице, или -1, если такого индекса нет.
Parameters
searchElement: T
Optional fromIndex: undefined | number
Returns number
insert
insert(index?: undefined | number): T
Метод добавляет новую строку в таблицу и возвращает ссылку на неё.
Parameters
Optional index: undefined | number
Returns T
Новая строка таблицы.
join
join(separator?: undefined | string): string
Метод объединяет все элементы таблицы в строку.
Parameters
Optional separator: undefined | string
Returns string
lastIndexOf
lastIndexOf(searchElement: T, fromIndex?: undefined | number): number
Метод возвращает последний индекс, по которому данный элемент может быть найден в таблице, или -1, если такого индекса нет. Таблица просматривается от конца к началу, начиная с индекса fromIndex.
Parameters
searchElement: T
Optional fromIndex: undefined | number
Returns number
map
map<U>(callback: function, thisArg?: any): U[]
Метод создаёт новый массив с результатом вызова указанной функции для каждого элемента таблицы.
Внимание: возвращаемое значение — это обычный массив, который не является таблицей.
Type parameters
U
Parameters
callback: function
(value: T, index: number, array: readonly T[]): U
Parameters
value: T
index: number
array: readonly T[]
Returns U
Optional thisArg: any
Returns U[]
Новый массив, где каждый элемент является результатом callback функции.
Возвращает true, если функция проверки возвращает истинное значение хотя бы для одного элемента таблицы. Иначе false.
toLocaleString
toLocaleString(): string
Метод возвращает строковое представление элементов таблицы.
Элементы преобразуются в строки с использованием своих собственных методов toLocaleString,
и эти строки разделяются локалезависимой строкой, например, запятой (,).
Returns string
toString
toString(): string
Метод возвращает строковое представление элементов таблицы.
Для таблицы метод toString соединяет массив и возвращает одну строку,
содержащую все элементы массива, разделённые запятыми.
Таблица
Таблица — это тип переменной, представляющий собой массив данных — строк таблицы. Каждая строка является отдельным элементом массива и представляет собой объект, свойства которого определены столбцами таблицы.
Подробнее про работу с таблицами можете почитать в статье «Начало работы с типом данных Таблица».
Type parameters
T: ItemData
R: ItemData
Hierarchy
Properties
Readonly length
Свойство TTable.length возвращает число элементов таблицы.
Значение данного свойства — 32-битное беззнаковое целое число, которое всегда больше, чем наибольший индекс в массиве.
Readonly result
Строка вычисляемого результата в таблице.
В этой строке могут быть настроены вычисления суммы, среднего, количества.
Methods
concat
Метод возвращает новый массив, состоящий из массива элементов таблицы, соединённого с другими массивами и/или значениями, переданными в качестве аргументов.
Внимание: возвращаемое значение — это обычный массив, который не является таблицей.
Parameters
Rest ...items: (T | ConcatArray<T>)[]
Returns T[]
Новый массив, содержащий все элементы.
delete
Метод удаляет конкретную строку из заданной таблицы.
Parameters
index: number
Returns void
every
Метод проверяет, удовлетворяют ли все элементы таблицы условию, заданному в передаваемой функции.
Внимание: метод возвращает
trueпри любом условии для пустой таблицы.Parameters
predicate: function
Parameters
value: T
index: number
array: readonly T[]
Returns unknown
Optional thisArg: any
Returns boolean
Возвращает
true, если функция проверки возвращает истинное значение для каждого элемента таблицы. Иначеfalse.filter
Метод создаёт новый массив со всеми элементами, прошедшими проверку, задаваемую в передаваемой функции.
Внимание: возвращаемое значение — это обычный массив, который не является таблицей.
Parameters
predicate: function
Parameters
value: T
index: number
array: readonly T[]
Returns unknown
Optional thisArg: any
Returns T[]
Новый массив с элементами, которые прошли проверку. Если ни один элемент не прошёл проверку, то будет возвращён пустой массив.
find
Метод возвращает значение первого найденного в таблице элемента, которое удовлетворяет условию, переданному в функции
predicate. В противном случае возвращаетсяundefined.Parameters
predicate: function
Parameters
value: T
index: number
array: readonly T[]
Returns unknown
Optional thisArg: any
Returns T | undefined
findIndex
Метод возвращает индекс в массиве, если элемент удовлетворяет условию проверяющей функции. В противном случае возвращается -1.
Parameters
predicate: function
Parameters
value: T
index: number
array: readonly T[]
Returns unknown
Optional thisArg: any
Returns number
forEach
Метод выполняет указанную функцию один раз для каждого элемента в таблице.
Parameters
callback: function
Parameters
value: T
index: number
array: readonly T[]
Returns void
Optional thisArg: any
Returns void
indexOf
Метод возвращает первый индекс, по которому данный элемент может быть найден в таблице, или -1, если такого индекса нет.
Parameters
searchElement: T
Optional fromIndex: undefined | number
Returns number
insert
Метод добавляет новую строку в таблицу и возвращает ссылку на неё.
Parameters
Optional index: undefined | number
Returns T
Новая строка таблицы.
join
Метод объединяет все элементы таблицы в строку.
Parameters
Optional separator: undefined | string
Returns string
lastIndexOf
Метод возвращает последний индекс, по которому данный элемент может быть найден в таблице, или -1, если такого индекса нет. Таблица просматривается от конца к началу, начиная с индекса
fromIndex.Parameters
searchElement: T
Optional fromIndex: undefined | number
Returns number
map
Метод создаёт новый массив с результатом вызова указанной функции для каждого элемента таблицы.
Внимание: возвращаемое значение — это обычный массив, который не является таблицей.
Type parameters
U
Parameters
callback: function
Parameters
value: T
index: number
array: readonly T[]
Returns U
Optional thisArg: any
Returns U[]
Новый массив, где каждый элемент является результатом
callbackфункции.reduce
Метод применяет функцию reducer к каждому элементу таблицы (слева направо), возвращая одно результирующее значение.
Parameters
callback: function
Parameters
previousValue: T
currentValue: T
index: number
array: readonly T[]
Returns T
Optional initialValue: T
Returns T
Метод применяет функцию reducer к каждому элементу таблицы (слева направо), возвращая одно результирующее значение.
Type parameters
U
Parameters
callback: function
Parameters
previousValue: U
currentValue: T
index: number
array: readonly T[]
Returns U
Optional initialValue: U
Returns U
reduceRight
Метод применяет функцию к аккумулятору и каждому значению таблицы (справа налево), сводя его к одному значению.
Parameters
callback: function
Parameters
previousValue: T
currentValue: T
index: number
array: readonly T[]
Returns T
Optional initialValue: T
Returns T
Метод применяет функцию к аккумулятору и каждому значению таблицы (справа налево), сводя его к одному значению.
Type parameters
U
Parameters
callback: function
Parameters
previousValue: U
currentValue: T
index: number
array: readonly T[]
Returns U
Optional initialValue: U
Returns U
slice
Метод возвращает новый массив, содержащий копию части исходной таблицы.
Внимание: возвращаемое значение — это обычный массив, который не является таблицей.
Parameters
Optional start: undefined | number
Optional end: undefined | number
Returns T[]
Новый массив, содержащий выборку элементов таблицы.
some
Метод проверяет, удовлетворяет ли какой-либо элемент таблицы условию, заданному в передаваемой функции.
Внимание: метод возвращает
falseпри любом условии для пустой таблицы.Parameters
predicate: function
Parameters
value: T
index: number
array: readonly T[]
Returns unknown
Optional thisArg: any
Returns boolean
Возвращает
true, если функция проверки возвращает истинное значение хотя бы для одного элемента таблицы. Иначеfalse.toLocaleString
Метод возвращает строковое представление элементов таблицы.
Элементы преобразуются в строки с использованием своих собственных методов
toLocaleString, и эти строки разделяются локалезависимой строкой, например, запятой (,).Returns string
toString
Метод возвращает строковое представление элементов таблицы.
Для таблицы метод
toStringсоединяет массив и возвращает одну строку, содержащую все элементы массива, разделённые запятыми.Returns string