A1sCodeбиблиотека 1С

A1sDS

Открыть A1sDS.bsl

Назначение: Упрощённая работа со структурами и парами ключ-значение.
Переименование: Модуль ранее назывался A1sStruct, теперь переименован в A1sDS (Data Structures).

Функции и процедуры (Экспорт)

  • Of — Создает структуру из произвольного количества пар ключ-значение (до 20).
  • Pair — Создает пару ключ-значение в виде структуры с полями Ключ и Значение.
  • OfPairs — Создает структуру из массива пар, где каждая пара — структура с полями Ключ и Значение.
  • Struct — Создает структуру из плоского массива пар [ключ1, значение1, ключ2, значение2].
  • OfKeysAndValues — Создает структуру из двух массивов: массива ключей и массива значений.
  • OfString — Создает структуру из строки ключей и массива значений.
  • OfQueryString — Создает структуру из строки вида "Ключ=Значение, Ключ2=Значение2".
  • OfPick — Создает структуру из другой структуры, выбирая только указанные ключи.
  • OfOmit — Создает структуру из другой структуры, исключая указанные ключи.
  • OfDefaults — Создает структуру, объединив данные с заданными значениями по умолчанию.
  • OfRename — Создает новую структуру с переименованными ключами.
  • AddIf — Условно добавляет значение в структуру в зависимости от условия.
  • Concatenate — Объединяет до 8 структур, значения последующих перезаписывают предыдущие.
  • Union — Объединение множеств ключей до 8 структур — возвращает структуру со всеми уникальными ключами.
  • Intersection — Возвращает структуру с ключами, которые есть во всех переданных структурах (пересечение до 8 структур).
  • Difference — Возвращает структуру с ключами из первой структуры, которых нет в остальных структурах (разность до 8 структур).
  • ToFixed — Создает фиксированную структуру из структуры или массива пар.
  • ToPairs — Преобразует структуру в массив пар {Ключ, Значение}.
  • DeepCopy — Глубокое копирование структуры (рекурсивно копирует вложенные структуры).
  • HasKey — Проверяет наличие ключа в структуре.
  • GetKeys — Возвращает массив ключей структуры.
  • GetValues — Возвращает массив значений структуры.
  • ToString — Преобразует структуру в строковое представление.
  • IsEmpty — Проверяет, пуста ли структура (нет свойств).
  • GetOrInsert — Возвращает значение по ключу из структуры; если ключа нет — вставляет значение по умолчанию и возвращает его.
  • GetOrInsertEval — Возвращает значение по ключу; если ключа нет — вставляет результат вычисления выражения.
  • GetOrInsertPath — Вставляет значение по «пути ключей» в структуре (создаёт промежуточные узлы) и возвращает конечное значение.
  • SelfTest — Самотест модуля A1sDS с примерами использования.
  • ExamplesAdvanced — Расширенные примеры использования функций модуля A1sDS.
  • GetVersion — Возвращает версию модуля A1sDS.
Источник подтверждения: https://a1scode.ru/A1sDS.bsl