Перейти к основному содержимому

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

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

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

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

Сравнение

Структурное

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

Обход в цикле

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

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

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

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

Дочерние типы: ИзменяемоеСоответствие


Примеры

Сравнение

знч ОбычноеСоответствие = новый Соответствие<Строка, Число>({"ключ1": 1, "ключ2": 2})
знч ЧитаемоеСоответствие = новый ЧитаемоеСоответствие<Объект, Объект>({"ключ2": 2, "ключ1": 1})

знч Равны = ОбычноеСоответствие == ЧитаемоеСоответствие // Истина

Литералы

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

Примеры

знч ПустоеСоответствие1: ЧитаемоеСоответствие<Строка, Число> = {:}  // сработал вывод типа
знч ПустоеСоответствие2 = <Строка, Число>{:}
знч СоответствиеТипизированное = {"ключ1" : 1, "ключ2" : 2}
знч СоответствиеОбъектов = <Объект, Объект>{"ключ1" : 1, Истина : "значение2"}

Операция []

Только чтение

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

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

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


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

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

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


Методы

ВСтроку

ВСтроку(): Строка
Возвращает строковое представление соответствия в виде: "{ключ_0 : значение_0, ..., ключ_n : значение_n}"

Переопределение
Объект::ВСтроку


Значения

Значения(): ЧитаемаяКоллекция<ТипЗначения>
Возвращает коллекцию значений соответствия.


Ключи

Ключи(): ЧитаемоеМножество<ТипКлюча>
Возвращает множество ключей соответствия.


Получить

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

Исключения

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


ПолучитьИлиНеопределено

Версия 7.0 и выше

ПолучитьИлиНеопределено(Ключ: ТипКлюча): ТипЗначения?
Возвращает значение, соответствующее ключу Ключ или Undefined, если соответствие не содержит переданный ключ.

Прошлые имена: ПолучитьИлиУмолчание


ПолучитьИлиУмолчание

Версия 7.0 и выше

ПолучитьИлиУмолчание(
Ключ: ТипКлюча,
Умолчание: ТипЗначения
): ТипЗначения
Возвращает значение, соответствующее ключу Ключ или значение Умолчание, если соответствие не содержит переданный ключ.

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


ПолучитьИлиУмолчание

Версия 7.0 и выше

ПолучитьИлиУмолчание<ТипУмолчания>(
Ключ: ТипКлюча,
ВычислительУмолчания: ()->ТипЗначения|ТипУмолчания
): ТипЗначения|ТипУмолчания
ТипУмолчания: Тип умолчания.

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

Перегрузка
ПолучитьИлиУмолчание(Ключ: ТипКлюча, Умолчание: ТипЗначения): ТипЗначения


ПолучитьИлиУмолчание

Версия 6.0 и ниже

ПолучитьИлиУмолчание(Ключ: ТипКлюча): ТипЗначения?
Метод переименован в ПолучитьИлиНеопределено.


ПолучитьИлиУмолчание

Версия 6.0 и ниже

ПолучитьИлиУмолчание<ТипУмолчания>(
Ключ: ТипКлюча,
Умолчание: ТипЗначения|ТипУмолчания
): ТипЗначения|ТипУмолчания
Метод заменен на ПолучитьИлиУмолчание.


Размер

Размер(): Число
Возвращает количество элементов в соответствии.


Содержит

Содержит(
Ключ: ТипКлюча,
Значение: ТипЗначения
): Булево
Проверяет, содержится ли пара Ключ и Значение в соответствии.


СодержитЗначение

СодержитЗначение(Значение: ТипЗначения): Булево
Проверяет, содержится ли значение Значение в соответствии.


СодержитКлюч

СодержитКлюч(Ключ: ТипКлюча): Булево
Проверяет, содержится ли ключ Ключ в соответствии.


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

Обходимое

ВМассив

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

ВСоответствиеСКлючами

ВСоответствиеСоЗначениями

ВоМножество

ВсеСоответствуют

ГруппироватьПо

ГруппироватьПо

ГруппироватьПо

ДляКаждого

Единственный

ЕдинственныйИлиНеопределено

ЕдинственныйИлиУмолчание

ЕдинственныйИлиУмолчание

ЕстьСоответствия

КакПоследовательность

Максимум

МаксимумПо

Минимум

МинимумПо

НетСоответствий

Объединить

Первый

ПервыйИлиНеопределено

ПервыйИлиУмолчание

ПервыйИлиУмолчание

ПотомСортироватьПо

Преобразовать

ПреобразоватьЛинейно

Пусто

Свернуть

Свернуть

Соединить

Сортировать

Сортировать

СортироватьПо

Среднее

СреднееИлиУмолчание

Сумма

Уникальные

УникальныеПо

Фильтровать

ФильтроватьПоТипу

Объект

ВСтроку (Переопределение)

ПолучитьТип

Представление