- Создание соответствия
- Добавление значения в соответствие
- Ключ соответствия
- Получить значение соответствия
- Обращение к ключам соответствия
- Перебор соответствия
- Как удалить ключ из соответствия
- Поиск по соответствию
- Количество элементов соответствия
- Как скопировать соответствие
- Как преобразовать соответствие в структуру
- Фиксированное соответствие
Создание соответствия
Соответствие — это универсальная коллекция, которая хранит соответствие некого ключа и значения. Если сравнивать с другими языка программирования, то соответствие это хеш-таблица или словарь. Элементами коллекции являются объекты типа КлючИЗначение. При этом и ключ и значение соответствия могут быть любого типа (в отличии от структуры, где ключ может быть только строкой). Соответствие может быть передано с клиента на сервер, и с сервера на клиент.
Для создания соответствия используется следующий конструктор:
|
1 2 |
//пустое соответствие ОбъектСоответствие = Новый Соответствие; |
В результате будет создано пустое соответствие.
Добавление значения в соответствие
Для добавления нового значения в соответствие используется метод Вставить. Если в соответствии уже есть значение с таким ключом, то оно будет заменено.
|
1 2 |
ОбъектСоответствие.Вставить("Ключ1", 1); ОбъектСоответствие.Вставить("Ключ2", 2); |
Также можно добавлять новые значения через квадратные скобки [ ]
|
1 2 |
ОбъектСоответствие["Ключ1"] = 1; ОбъектСоответствие["Ключ2"] = 2; |
Ключ соответствия
В качестве ключа соответствия может выступать значение любого типа:
|
1 2 3 4 5 6 7 8 |
//тип ключа может быть произвольным ОбъектСоответствие = Новый Соответствие; ОбъектСоответствие["Ключ1"] = 1; //строка ОбъектСоответствие[2] = 2; //число ОбъектСоответствие[Истина] = Истина; //булево Ссылка = ПредопределенноеЗначение("Справочник.Товары.Товар"); ОбъектСоответствие[Ссылка]= "Ссылка"; //ссылка //и т.д. |
В одном соответствии не может быть больше одного элемента с одинаковым ключом.
Получить значение соответствия
Для того чтобы получить значение соответствия по ключу можно воспользоваться методом Получить или использовать квадратные скобки [ ]:
|
1 2 |
Значение1 = ОбъектСоответствие["Ключ1"]; Значение2 = ОбъектСоответствие.Получить("Ключ2"); |
Если такого ключа нет в соответствии, то будет получено Неопределено.
Обращение к ключам соответствия
К ключам соответствия удобно обращаться через квадратные скобки. Если в соответствии нет такого ключа и попытаться получить его, то ошибки не будет (вернет Неопределено). Если попытаться изменить значение, то если такого ключа еще не было, то значение будет добавлено в соответствие. Если такой ключ уже есть — значение будет заменено.
|
1 2 3 4 5 |
ОбъектСоответствие = Новый Соответствие; Значение = ОбъектСоответствие["Ключ1"]; //Значение = неопределено ОбъектСоответствие["Ключ1"] = 1; Значение = ОбъектСоответствие["Ключ1"]; //Значение = 1 ОбъектСоответствие["Ключ1"] = Ложь; //теперь Значение = Ложь |
Перебор соответствия
Перебрать соответствие можно через цикл Для Каждого. На каждой итерации будет получен объект КлючИЗначение. У данного объекта есть свойства Ключ и Значение. При этом элементы коллекции получаются в произвольном порядке.
|
1 2 3 4 |
Для Каждого СтрСоотв Из ОбъектСоответствие Цикл Сообщить(СтрСоотв.Ключ); Сообщить(СтрСоотв.Значение); КонецЦикла; |
Как удалить ключ из соответствия
Методом Удалить можно удалить один ключ из соответствия. Методом Очистить можно удалить все ключи:
|
1 2 3 4 5 |
//удалить элемент с ключом Ключ1 ОбъектСоответствие.Удалить("Ключ1"); //удалить все элементы из соответствия ОбъектСоответствие.Очистить(); |
Поиск по соответствию
Чтобы найти какой-то ключ в соответствии нужно получить значение по ключу и сравнить его с Неопределено. Если оно не равно Неопределено, то такой ключ есть в соответствии:
|
1 2 3 |
ЕстьКлюч = ОбъектСоответствие["Ключ1"] <> Неопределено; //Если в соответствии есть ключ "Ключ1", то //переменная ЕстьКлюч будет равна Истина, иначе Ложь |
Соответствие удобно использовать для быстрого поиска значения по ключу. Время поиска в соответствии константное и не зависит от количества элементов в соответствии (в отличии от массива, где значение ищется перебором, и чем больше элементов в массиве, тем медленнее ищется значение).
Количество элементов соответствия
Для получения количества всех элементов соответствия удобно использовать метод Количество:
|
1 |
Колво = ОбъектСоответствие.Количество(); |
Как скопировать соответствие
|
1 |
Копия = ЗначениеИзСтрокиВнутр(ЗначениеВСтрокуВнутр(ОбъектСоответствие)); |
Как преобразовать соответствие в структуру
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
ОбъектСоответствие= Новый Соответствие; ОбъектСоответствие.Вставить("Ключ1", 1); ОбъектСоответствие.Вставить("Ключ2", 2); ОбъектСоответствие.Вставить(1234, 5678); ОбъектСоответствие.Вставить(Истина, Ложь); Ссылка = ПредопределенноеЗначение("Справочник.Товары.Товар"); ОбъектСоответствие.Вставить(Ссылка, "Ссылка"); СтруктураПараметров = Новый Структура; Для Каждого СтрСоотв Из ОбъектСоответствиеЦикл //в попытке пробуем преобразовать ключ соответствия в строку Попытка //так как ключ структуры не может начинаться с числа, то для //чисел добавляем в начале нижнее подчеркивание Если ТипЗнч(СтрСоотв.Ключ) = Тип("Число") Тогда Префикс = "_"; Иначе Префикс = ""; КонецЕсли; //через Формат удаляем возможные неразрывные пробелы КлючСтруктуры = Префикс + Формат(СтрСоотв.Ключ, "ЧГ=0"); СтруктураПараметров.Вставить(КлючСтруктуры, СтрСоотв.Значение); Исключение //здесь можно что-то дополнительно сделать с необработанными ключами Сообщить(ОписаниеОшибки()); КонецПопытки; КонецЦикла; |
Фиксированное соответствие
Фиксированное соответствие создается только на основании обычного соответствия. После его создания нельзя изменить ни ключ, ни значение существующих элементов. Также нельзя добавить новые элементы в соответствие.
|
1 2 3 4 5 6 7 8 |
ОбъектСоответствие = Новый Соответствие; ОбъектСоответствие["Ключ1"] = 1; ОбъектСоответствие["Ключ2"] = 2; ФиксСоот = Новый ФиксированноеСоответствие(ОбъектСоответствие); //В соответствии ФиксСоот будет 2 ключа: //Ключ1 = 1 //Ключ2 = 2 |
На основании фиксированного соответствия можно создать обычное соответствие:
|
1 2 3 4 |
//фиксированное ФиксСоот = Новый ФиксированноеСоответствие(ОбъектСоответствие); //обычное с теми же ключами и значения, что и фиксированное ОбычноеСоответствие = Новый Соответствие(ФиксСоот); |
Если через квадратные скобки обратиться к ключу фиксированного соответствия, которого в нем нет, то будет вызвано исключение:
|
1 2 3 4 5 6 7 8 9 |
ОбъектСоответствие = Новый Соответствие; ОбъектСоответствие["Ключ1"] = 1; ОбъектСоответствие["Ключ2"] = 2; //фиксированное ФиксСоот = Новый ФиксированноеСоответствие(ОбъектСоответствие); Значение1 = ФиксСоот["Ключ1"]; //все хорошо Значение3 = ФиксСоот["Ключ3"]; //ошибка! //хотя в обычном соответствии просто вернуло бы Неопределено |
У фиксированного соответствия есть только 2 метода:
- Количество()
- Получить(<Ключ>)
Через метод Получить можно обращаться к несуществующему ключу фиксированного соответствия. В этом случае метод, как и для обычного соответствия, вернет Неопределено.
