Коллекции (ЮТКоллекции)

Методы модуля

---

ЗначениеСтруктуры

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

Параметры метода

• ИсходнаяСтруктура
  • Структура - Исходная структура
• ИмяПоля
  • Строка - Имя поля структуры
• ЗначениеПоУмолчанию
  • Произвольный - Значение, которое будет возвращено, если поля в структуре нет

Возвращает

Произвольный - Значение искомого поля структуры

---

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

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

Параметры метода

• ИсходноеСоответствие
  • Соответствие - Исходное соответствие
• Ключ
  • Произвольный - Ключ поиска
• ЗначениеПоУмолчанию
  • Произвольный - Значение, которое будет возвращено, если ключа в соответствии нет

Возвращает

Произвольный - Значение ключа соответствия

---

ДополнитьСтруктуру

Добавляет в приемник данные из источника, при совпадении ключей значения заменяются

Параметры метода

• Приемник
  • Структура -
• Источник
  • Соответствие из Произвольный -
  • Структура -

---

ДополнитьМассив

Добавляет в приемник все элементы источника

Параметры метода

• Приемник
  • Массив из Произвольный -
• Источник
  • Массив из Произвольный -

---

ОбъединитьМассивы

Создает новый массив путем объединения входных.

Параметры метода

• Коллекция1
  • Массив Из Произвольный -
• Коллекция2
  • Массив Из Произвольный -
• Коллекция3
  • Массив Из Произвольный -
• Коллекция4
  • Массив Из Произвольный -

Возвращает

Массив из Произвольный - Результат объединения

---

СкопироватьРекурсивно

Создает копию экземпляра указанного объекта. Примечание: Функцию нельзя использовать для объектных типов (СправочникОбъект, ДокументОбъект и т.п.).

Параметры метода

• Источник
  • Произвольный - объект, который необходимо скопировать.

Возвращает

Произвольный - копия объекта, переданного в параметре Источник.

---

СкопироватьСтруктуру

Создает копию структуры

Параметры метода

• Источник
  • Структура - копируемая структура
  • ФиксированнаяСтруктура - копируемая структура
• Рекурсивно
  • Булево - Создание "глубокой" копии, с копирование вложенных элементов

Возвращает

Структура - копия исходной структуры.

---

СкопироватьСоответствие

Создает копию соответствия

Параметры метода

• Источник
  • Соответствие из Произвольный -
  • ФиксированноеСоответствие из Произвольный -
• Рекурсивно
  • Булево - Создание "глубокой" копии, с копирование вложенных элементов

Возвращает

Соответствие Из Произвольный - копия исходного соответствия.

---

СкопироватьМассив

Создает копию массива

Параметры метода

• Источник
  • Массив Из Произвольный -
  • ФиксированныйМассив из Произвольный -
• Рекурсивно
  • Булево - Создание "глубокой" копии, с копирование вложенных элементов

Возвращает

Массив Из Произвольный - копия исходного массива.

---

СкопироватьСписокЗначений

Создает копию списка значений

Параметры метода

• Источник
  • СписокЗначений Из Произвольный -
• Рекурсивно
  • Булево - Создание "глубокой" копии, с копирование вложенных элементов

Возвращает

СписокЗначений Из Произвольный -

---

ВыгрузитьЗначения

Выгружает значения "колонки" коллекции элементов.

Параметры метода

• Коллекция
  • Произвольный - Итерируемая коллекция
• ИмяРеквизита
  • Строка - Имя реквизита элементов коллекции

Возвращает

Массив из Произвольный -

---

ПересечениеМассивов

Вычисляет двух массивов, коллекцию содержащую общие элементы.

Параметры метода

• Коллекция1
  • Массив из Произвольный -
• Коллекция2
  • Массив из Произвольный -

Возвращает

Массив из Произвольный - Пересечение массивов

---

ЗначениеВМассиве

Создает массив с переданными значениями

Параметры метода

• Значение1
  • Произвольный -
• Значение2
  • Произвольный -
• Значение3
  • Произвольный -
• Значение4
  • Произвольный -
• Значение5
  • Произвольный -
• Значение6
  • Произвольный -
• Значение7
  • Произвольный -
• Значение8
  • Произвольный - Значение9 - Произвольный
• Значение9 -
• Значение10
  • Произвольный -

Возвращает

Массив из Произвольный - Массив переданных значений @skip-check method-too-many-params BSLLS:NumberOfOptionalParams-off BSLLS:NumberOfParams-off BSLLS:DuplicateStringLiteral-off

---

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

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

Параметры метода

• Коллекция
  • Произвольный - значение, для которого определен итератор, и возможно обращение к полям элементов через квадратные скобки.
• ИмяПоляКлюча
  • Строка - имя поля элемента коллекции, которое будет ключом соответствия.
• ИмяПоляЗначения
  • Строка - если указан, значениями результата будут не элементы, а значения соответствующих полей элементов коллекции.

Возвращает

Соответствие Из Произвольный - полученное соответствие.

---

ВСтруктуру

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

Параметры метода

• Коллекция
  • Произвольный - значение, для которого определен итератор, и возможно обращение к полям элементов через квадратные скобки.
• ИмяПоляКлюча
  • Строка - имя поля элемента коллекции, которое будет ключом соответствия.
• ИмяПоляЗначения
  • Строка - если указан, значениями результата будут не элементы, а значения соответствующих полей элементов коллекции.

Возвращает

Структура Из Произвольный - полученная структура.

---

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

Формирует текстовое представление массива. Пример результата - "[1, 2, 3]"

Параметры метода

• Данные
  • Массив из Строка -

Возвращает

Строка -

---

МассивВСтруктуру

Создает структуру из массива. Ключами будут элементы массива, а значением каждого элемента структуры - параметр ЗначениеСтруктуры

Параметры метода

• Значения
  • Массив из Строка -
• ЗначениеСтруктуры
  • Произвольный -

Возвращает

Структура -

---

ОбратныйПорядок

Возвращает массив с обратной последовательностью элементов

Параметры метода

• Значения
  • Массив Из Произвольный -

Возвращает

Массив Из Произвольный - Перевернутый массив