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

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

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

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

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

graph BT;
Соответствие&ltТипКлюча,ТипЗначения&gt-->ИзменяемоеСоответствие&ltТипКлюча,ТипЗначения&gt;
ИзменяемоеСоответствие&ltТипКлюча,ТипЗначения&gt-->ЧитаемоеСоответствие&ltТипКлюча,ТипЗначения&gt;
ЧитаемоеСоответствие&ltТипКлюча,ТипЗначения&gt-->Обходимое&ltКлючИЗначение&ltТипКлюча,ТипЗначения&gt&gt;
Обходимое&ltКлючИЗначение&ltТипКлюча,ТипЗначения&gt&gt-->Объект;

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

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

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

Обход в цикле:

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

Тип: КлючИЗначение<KeyType, ValueType>

Литералы

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

Операция []

[Ключ: ТипКлюча]: ТипЗначения

Изменяемый

ИсключениеНедопустимыйАргумент - если соответствие не содержит указанный ключ.

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

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

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

Соответствие()

Перегрузка:
Соответствие(Соответствие: ЧитаемоеСоответствие<ТипКлюча, ТипЗначения>)

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

Примеры

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

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

Соответствие(Соответствие: ЧитаемоеСоответствие<ТипКлюча, ТипЗначения>)

Перегрузка:
Соответствие()

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

Методы

Вставить

Вставить(КлючИЗначение: КлючИЗначение<ТипКлюча, ТипЗначения>): ТипЗначения?

Перегрузка:
Вставить(Ключ: ТипКлюча, Значение: ТипЗначения): ТипЗначения?

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

Вставить

Вставить(
  Ключ: ТипКлюча,
  Значение: ТипЗначения
): ТипЗначения?

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

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

ВставитьВсе

ВставитьВсе(Соответствие: ЧитаемоеСоответствие<ТипКлюча, ТипЗначения>)

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

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

ВставитьЕслиОтсутствует(КлючИЗначение: КлючИЗначение<ТипКлюча, ТипЗначения>): ТипЗначения

Перегрузка:
ВставитьЕслиОтсутствует(Ключ: ТипКлюча, Значение: ТипЗначения): ТипЗначения

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

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

ВставитьЕслиОтсутствует(
  Ключ: ТипКлюча,
  Значение: ТипЗначения
): ТипЗначения

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

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

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

ИзменяемоеСоответствие

Очистить, Удалить, Удалить

Обходимое

ВМассив, ВСоответствие, ВСоответствие, ВоМножество, ВсеСоответствуют, ГруппироватьПо, ДляКаждого, Единственный, ЕдинственныйИлиУмолчание, ЕдинственныйИлиУмолчание, ЕстьСоответствия, КакПоследовательность, Максимум, МаксимумПо, Минимум, МинимумПо, НетСоответствий, Объединить, ПервыйИлиУмолчание, ПервыйИлиУмолчание, ПотомСортироватьПо, Преобразовать, ПреобразоватьЛинейно, Пусто, Свернуть, Свернуть, Соединить, Сортировать, Сортировать, СортироватьПо, Уникальные, УникальныеПо, Фильтровать

Объект

ПолучитьТип, Представление

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

ВСтроку, Значения, Ключи, Получить, ПолучитьИлиУмолчание, ПолучитьИлиУмолчание, Размер, Содержит, СодержитЗначение, СодержитКлюч