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

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

ТипКлюча: тип ключей соответствия.

ТипЗначения: тип значений соответствия.

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

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

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

Литералы

Синтаксис (краткий): { ключ_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?

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