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

Стд::Коллекции::Соответствие<ТипКлюча,ТипЗначения> Доступность: КлиентИСервер

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

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

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

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

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

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

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

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

---

Литералы

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

---

Операция []

Изменяемый

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

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

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

---

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

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

Доступность: КлиентИСервер

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

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

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

Примеры

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

---

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

Доступность: КлиентИСервер

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

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

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

---

Методы

Вставить

Доступность: КлиентИСервер

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

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

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

---

Вставить

Доступность: КлиентИСервер

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

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

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

---

Вставить

Доступность: КлиентИСервер

Вставить(
Ключ: ТипКлюча,
ВычислительНачальногоЗначения: (ТипКлюча)->ТипЗначения,
ВычислительИзменяемогоЗначения: (ТипКлюча, ТипЗначения)->ТипЗначения
): ТипЗначения

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

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

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

---

ВставитьВсе

Доступность: КлиентИСервер

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

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

---

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

Доступность: КлиентИСервер

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

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

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

---

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

Доступность: КлиентИСервер

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

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

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

---

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

Доступность: КлиентИСервер

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

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

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

ВычислительЗначения - функция, используемая для вычисления нового значения. Принимает ключ, для которого будет вычисляться значение.

---

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

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

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

Обходимое

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

Объект

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

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

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