search string side menu

Таблица

Таблица — это тип переменной, представляющий собой массив данных — строк таблицы. Каждая строка является отдельным элементом массива и представляет собой объект, свойства которого определены столбцами таблицы.

Подробнее про работу с таблицами можете почитать в статье «Начало работы с типом данных Таблица».

Type parameters

Hierarchy

  • TTable

Properties

Readonly length

length: number

Свойство 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

  • Метод удаляет конкретную строку из заданной таблицы.

    Parameters

    • index: number

    Returns void

every

  • every(predicate: function, thisArg?: any): boolean

  • Метод проверяет, удовлетворяют ли все элементы таблицы условию, заданному в передаваемой функции.

    Внимание: метод возвращает true при любом условии для пустой таблицы.

    Parameters

    • predicate: function
        • (value: T, index: number, array: readonly T[]): unknown

        • Parameters

          • value: T
          • index: number
          • array: readonly T[]

          Returns unknown

    • Optional thisArg: any

    Returns boolean

    Возвращает true, если функция проверки возвращает истинное значение для каждого элемента таблицы. Иначе false.

filter

  • filter(predicate: function, thisArg?: any): T[]

  • Метод создаёт новый массив со всеми элементами, прошедшими проверку, задаваемую в передаваемой функции.

    Внимание: возвращаемое значение — это обычный массив, который не является таблицей.

    Parameters

    • predicate: function
        • (value: T, index: number, array: readonly T[]): unknown

        • Parameters

          • value: T
          • index: number
          • array: readonly T[]

          Returns unknown

    • Optional thisArg: any

    Returns T[]

    Новый массив с элементами, которые прошли проверку. Если ни один элемент не прошёл проверку, то будет возвращён пустой массив.

find

  • find(predicate: function, thisArg?: any): T | undefined

  • Метод возвращает значение первого найденного в таблице элемента, которое удовлетворяет условию, переданному в функции predicate. В противном случае возвращается undefined.

    Parameters

    • predicate: function
        • (value: T, index: number, array: readonly T[]): unknown

        • Parameters

          • value: T
          • index: number
          • array: readonly T[]

          Returns unknown

    • Optional thisArg: any

    Returns T | undefined

findIndex

  • findIndex(predicate: function, thisArg?: any): number

  • Метод возвращает индекс в массиве, если элемент удовлетворяет условию проверяющей функции. В противном случае возвращается -1.

    Parameters

    • predicate: function
        • (value: T, index: number, array: readonly T[]): unknown

        • Parameters

          • value: T
          • index: number
          • array: readonly T[]

          Returns unknown

    • Optional thisArg: any

    Returns number

forEach

  • forEach(callback: function, thisArg?: any): void

  • Метод выполняет указанную функцию один раз для каждого элемента в таблице.

    Parameters

    • callback: function
        • (value: T, index: number, array: readonly T[]): void

        • Parameters

          • value: T
          • index: number
          • array: readonly T[]

          Returns void

    • Optional thisArg: any

    Returns void

indexOf

  • 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 функции.

reduce

  • reduce(callback: function, initialValue?: T): T
  • reduce<U>(callback: function, initialValue?: U): U

  • Метод применяет функцию reducer к каждому элементу таблицы (слева направо), возвращая одно результирующее значение.

    Parameters

    • callback: function
        • (previousValue: T, currentValue: T, index: number, array: readonly T[]): T

        • Parameters

          • previousValue: T
          • currentValue: T
          • index: number
          • array: readonly T[]

          Returns T

    • Optional initialValue: T

    Returns T

  • Метод применяет функцию reducer к каждому элементу таблицы (слева направо), возвращая одно результирующее значение.

    Type parameters

    • U

    Parameters

    • callback: function
        • (previousValue: U, currentValue: T, index: number, array: readonly T[]): U

        • Parameters

          • previousValue: U
          • currentValue: T
          • index: number
          • array: readonly T[]

          Returns U

    • Optional initialValue: U

    Returns U

reduceRight

  • reduceRight(callback: function, initialValue?: T): T
  • reduceRight<U>(callback: function, initialValue?: U): U

  • Метод применяет функцию к аккумулятору и каждому значению таблицы (справа налево), сводя его к одному значению.

    Parameters

    • callback: function
        • (previousValue: T, currentValue: T, index: number, array: readonly T[]): T

        • Parameters

          • previousValue: T
          • currentValue: T
          • index: number
          • array: readonly T[]

          Returns T

    • Optional initialValue: T

    Returns T

  • Метод применяет функцию к аккумулятору и каждому значению таблицы (справа налево), сводя его к одному значению.

    Type parameters

    • U

    Parameters

    • callback: function
        • (previousValue: U, currentValue: T, index: number, array: readonly T[]): U

        • Parameters

          • previousValue: U
          • currentValue: T
          • index: number
          • array: readonly T[]

          Returns U

    • Optional initialValue: U

    Returns U

slice

  • slice(start?: undefined | number, end?: undefined | number): T[]

  • Метод возвращает новый массив, содержащий копию части исходной таблицы.

    Внимание: возвращаемое значение — это обычный массив, который не является таблицей.

    Parameters

    • Optional start: undefined | number
    • Optional end: undefined | number

    Returns T[]

    Новый массив, содержащий выборку элементов таблицы.

some

  • some(predicate: function, thisArg?: any): boolean

  • Метод проверяет, удовлетворяет ли какой-либо элемент таблицы условию, заданному в передаваемой функции.

    Внимание: метод возвращает false при любом условии для пустой таблицы.

    Parameters

    • predicate: function
        • (value: T, index: number, array: readonly T[]): unknown

        • Parameters

          • value: T
          • index: number
          • array: readonly T[]

          Returns unknown

    • Optional thisArg: any

    Returns boolean

    Возвращает true, если функция проверки возвращает истинное значение хотя бы для одного элемента таблицы. Иначе false.

toLocaleString

  • toLocaleString(): string

  • Метод возвращает строковое представление элементов таблицы.

    Элементы преобразуются в строки с использованием своих собственных методов toLocaleString, и эти строки разделяются локалезависимой строкой, например, запятой (,).

    Returns string

toString

  • toString(): string

  • Метод возвращает строковое представление элементов таблицы.

    Для таблицы метод toString соединяет массив и возвращает одну строку, содержащую все элементы массива, разделённые запятыми.

    Returns string