Link Search Menu Expand Document

Соответствие

Стд::Коллекции::Соответствие<ТипКлюча,ТипЗначения>
Базовые типы: Обходимое, Объект, ЧитаемоеСоответствие
ТипКлюча: тип ключей соответствия.
ТипЗначения: тип значений соответствия.

Иерархия типа

Обходимое
Объект
ЧитаемоеСоответствие
Соответствие

Коллекция пар ключ и значение, предоставляющее быстрое получение значения по ключу. Не содержит дубликатов ключей. Каждому ключу соответствует только одно значение.

  • KeyType - тип ключей соответствия.
  • ValueType - тип значений соответствия.

Сравнение структурное:

  • соответствия считаются равными, если их размер совпадает, а так же каждое из соответствий содержит все пары ключ-значение другого.
  • типы соответствий при этом не учитываются.

Литералы

Синтаксис (краткий): { ключ_0 : значение_0, ..., ключ_n : значение_n }, тип ключа и элементов соответствия выводится автоматически (если возможно). Синтаксис (с указанием типов): \<ТипКлюча, ТипЗначения\>{ ключ_0 : значение_0, ..., ключ_n : значение_n }. Синтаксис пустого соответствия: {:}


Операция []

[Ключ: KeyType]: ValueType
Изменяемый

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


Конструкторы

Соответствие

Соответствие()
Перегрузка:
Соответствие(Соответствие: ЧитаемоеСоответствие<KeyType, ValueType>)

Создает пустое соответствие.

Примеры

знч Соответствие = новый Соответствие<Строка, Число>()

Соответствие

Соответствие(Соответствие: ЧитаемоеСоответствие<KeyType, ValueType>)
Перегрузка:
Соответствие()

Конструктор копирования. Создает соответствие, содержащее копию элементов Соответствие.


Методы

Вставить

Вставить(КлючИЗначение: КлючИЗначение<KeyType, ValueType>): ValueType?
Перегрузка:
Вставить(Ключ: KeyType, Значение: ValueType): ValueType?

Вставляет в соответствие пару ключ-значение из переданного КлючИЗначение. Если пара с указанным значением ключа существует, то его значение заменяется, в противном случае добавляется новый элемент. Возвращает значение, которое раньше соответствовало ключу или Undefined, если в соответствии не было такого ключа.


Вставить

Вставить(
  Ключ: KeyType,
  Значение: ValueType
): ValueType?
Перегрузка:
Вставить(КлючИЗначение: КлючИЗначение<KeyType, ValueType>): ValueType?

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


ВставитьВсе

ВставитьВсе(Соответствие: ЧитаемоеСоответствие<KeyType, ValueType>)

Вставляет все пары ключ-значение из переданного Соответствие.


ВставитьЕслиОтсутствует

ВставитьЕслиОтсутствует(КлючИЗначение: КлючИЗначение<KeyType, ValueType>): ValueType
Перегрузка:
ВставитьЕслиОтсутствует(Ключ: KeyType, Значение: ValueType): ValueType

Вставляет в соответствие пару ключ-значение из переданного КлючИЗначение, если в соответствии не было такого ключа. Возвращает значение, соответствующее ключу после вызова метода.


ВставитьЕслиОтсутствует

ВставитьЕслиОтсутствует(
  Ключ: KeyType,
  Значение: ValueType
): ValueType
Перегрузка:
ВставитьЕслиОтсутствует(КлючИЗначение: КлючИЗначение<KeyType, ValueType>): ValueType

Вставляет пару Ключ и Значение в соответствие, если в соответствии не было такого ключа. Возвращает значение, соответствующее ключу после вызова метода.


Очистить

Очистить()

Удаляет все элементы соответствия.


Удалить

Удалить(Ключ: KeyType): ValueType?
Перегрузка:
Удалить(Ключ: KeyType, Значение: ValueType): Булево

Удаляет элемент соответствия с ключом Ключ. Возвращает значение соответствовавшее удаленному ключу или Undefined, если в соответствии не было такого ключа.


Удалить

Удалить(
  Ключ: KeyType,
  Значение: ValueType
): Булево
Перегрузка:
Удалить(Ключ: KeyType): ValueType?

Удаляет элемент соответствия с ключом Ключ и значением Значение. Возвращает признак изменения соответствия.


Список унаследованных методов

Обходимое

Объект

ЧитаемоеСоответствие