ЧитаемоеСоответствие
Стд::Коллекции::ЧитаемоеСоответствие<ТипКлюча,ТипЗначения>
ТипКлюча: тип ключей соответствия. ТипЗначения: тип значений соответствия.
Коллекция пар ключ и значение, предоставляющее быстрое получение значения по ключу, доступная только для чтения. Не содерж ит дубликатов ключей. Каждому ключу соответствует только одно значение.
Сравнение
Структурное
- соответствия считаются равными, если их размер совпадает, а так же каждое из соответствий содержит все пары ключ-значение другого.
- типы соответствий при этом не учитываются.
Обход в цикле
Тип: КлючИЗначение<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}"
Переопределение
Объект::ВСтроку
Значения
Значения(): ЧитаемаяКоллекция<ТипЗначения>В режимах совместимости до 9.0 возвращает только уникальные значения. Начиная с режима совместимости 9.0 возвращает значения, включая повторы.
Ключи
Ключи(): ЧитаемоеМножество<ТипКлюча>Получить
Получить(Ключ: ТипКлюча): ТипЗначенияКлюч в соответствии.
Исключения
ИсключениеНедопустимыйАргумент - если соответствие не содержит указанный ключ.
ПолучитьИлиНеопределено
Версия 7.0 и выше
ПолучитьИлиНеопределено(Ключ: ТипКлюча): ТипЗначения?Ключ или Неопределено, если соответствие не содержит переданный ключ.
Прошлые имена: ПолучитьИлиУмолчание
ПолучитьИлиУмолчание
Версия 7.0 и выше
ПолучитьИлиУмолчание(
Ключ: ТипКлюча,
Умолчание: ТипЗначения
): ТипЗначенияКлюч или значение Умолчание, если соответствие не содержит переданный ключ.
ПолучитьИлиУмолчание
Версия 7.0 и выше
ПолучитьИлиУмолчание<ТипУмолчания>(
Ключ: ТипКлюча,
ВычислительУмолчания: ()->ТипЗначения|ТипУмолчания
): ТипЗначения|ТипУмолчанияВозвращает значение, соответствующее ключу Ключ или значение, вычисленное с помощью ВычислительУмолчания, если соответствие не содержит переданный ключ.
Перегрузка
ПолучитьИлиУмолчание(Ключ: ТипКлюча, Умолчание: ТипЗначения): ТипЗначения
ПолучитьИлиУмолчание
Версия 6.0 и ниже
ПолучитьИлиУмолчание(Ключ: ТипКлюча): ТипЗначения?ПолучитьИлиУмолчание
Версия 6.0 и ниже
ПолучитьИлиУмолчание<ТипУмолчания>(
Ключ: ТипКлюча,
Умолчание: ТипЗначения|ТипУмолчания
): ТипЗначения|ТипУмолчанияРазмер
Размер(): ЧислоСодержит
Содержит(
Ключ: ТипКлюча,
Значение: ТипЗначения
): БулевоКлюч и Значение в соответствии.
СодержитЗначение
СодержитЗначение(Значение: ТипЗначения): БулевоЗначение в соответствии.
СодержитКлюч
СодержитКлюч(Ключ: ТипКлюча): БулевоКлюч в соответствии.