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

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

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

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

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

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

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

Возвращает

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

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

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

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

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

Возвращает

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает

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

Примеры:

Массив1 = Новый Массив;
Массив1.Добавить("Элемент1");
Массив1.Добавить("Элемент2");
Массив2 = Новый Массив;
Массив2.Добавить("Элемент3");
Массив3 = Новый Массив;
Массив3.Добавить("Элемент4");
Массив3.Добавить("Элемент5");
Результат = ЮТКоллекции.ОбъединитьМассивы(Массив1, Массив2, Массив3);
// Результат будет содержать элементы: "Элемент1", "Элемент2", "Элемент3", "Элемент4", "Элемент5"

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

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

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

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

Возвращает

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

Примеры:

ИсходнаяСтруктура = Новый Структура;
ИсходнаяСтруктура.Вставить("Ключ1", "Значение1");
ИсходнаяСтруктура.Вставить("Ключ2", Новый Массив);
ИсходнаяСтруктура.Ключ2.Добавить("Элемент1");
КопияСтруктуры = ЮТКоллекции.СкопироватьРекурсивно(ИсходнаяСтруктура);
// КопияСтруктуры будет содержать полную копию исходной структуры,
// включая вложенный массив

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

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

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

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

Возвращает

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

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

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

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

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

Возвращает

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

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

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

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

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

Возвращает

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

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

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

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

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

Возвращает

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

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

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

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

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

Возвращает

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

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

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

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

  • Коллекция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]"

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

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

Возвращает

Строка -

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

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

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

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

Возвращает

Структура -

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

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

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

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

Возвращает

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

МассивСтруктурИзТаблицы​

Преобразует таблицу в массив структур

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

  • Таблица
    • ТаблицаЗначений -

Возвращает

Массив из Структура - Массив структур из таблицы

МассивСтруктурВТаблицу​

Преобразует массив структур в таблицу значений

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

  • МассивСтруктур
    • Массив из Структура -

Возвращает

ТаблицаЗначений -

ПредставлениеТаблицы​

Преобразовывает таблицу значений в строку

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

  • ТаблицаЗначений
    • ТаблицаЗначений -

СтрокаТаблицыЗначенийВСтруктуру​

Преобразует строку таблицы значений в структуру. Свойства структуры и их значения совпадают с колонками переданной строки.

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

  • СтрокаТаблицыЗначений
    • СтрокаТаблицыЗначений -

Возвращает

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