Алхимический способ работы с двоичными данными — универсальная библиотека под версии 1С 8.х

При подготовке доклада на конференцию infostart teach event 2025 возникла идея сделать аналог оператора Выполнить под WEB клиент и мобильный клиент через создание внешней подключаемой обработки. На этом сайте представлен яркий пример упаковки обработок, расширения, конфигурация на функционале платформы 8.3.9 и новее: Yellow Packer и Распаковщик. Однако, работа с двоичными данными возможна и на более ранних версиях 1С, но для этого нужна функция Преобразовать64 , которая преобразует строку base64 в массив байтов и обратно из массива байт в base64. Пользуясь случаем, выражаю благодарность автору за её реализацию.

Данная библиотека представляет собой универсальный слой совместимости (Compatibility Layer), который реализует на уровне встроенного языка функции для работы с двоичными данными. Её ключевая цель — предоставить единый API (программный интерфейс) для абсолютно всех платформ 1С 8.x, включая версии 8.0.5 – 8.3.8, мобильные клиенты (КПК), а также конфигурации, работающие в режиме совместимости, где нативные объекты недоступны.

Ядро библиотеки основано на работе через массив байт. Вся логика построена на базовом типе Массив, где каждый элемент — число от 0 до 255 (байт). Это позволяет:

• Обойти отсутствие в старых версиях объектов Поток, БуферДвоичныхДанных, ХешированиеДанных.

• Не зависеть от режима совместимости и типа клиента (толстый/тонкий/веб/мобильный).

• Иметь одну кодовую базу для гетерогенных сред (например, сервер 8.3.12 и клиенты на КПК с 8.2).

Отличие библиотеки от платформы приведено в виде следующей таблицы:

Прямое применение библиотеки:

• Старые версии (1С 8.0–8.3.8) и мобильные клиенты/приложения и КПК, где нет современных методов работы с данными.

• Конфигурации со старым режимом совместимости (например, УПП).

• Разработчики внешних обработок, которым нужен один код для всех клиентов для версии 1С 8.х

• Унифицированный подход работы с небольшими файлами на 1С 8.х

Справочник функций библиотеки применительно к функциям платформы:

1. Базовые преобразования (используют XMLСтрока/XMLЗначение) 

2. Низкоуровневый парсинг и сборка (аналог Потока)

3. Преобразования данных и кодировок

Практический пример: чтение ширины и высоты из BMP на всех версиях 1С 8.х с помощью библиотеки:

// Универсальная функция, работающая на всех версиях 1С 8.x
Процедура ПрочитатьРазмерыBMP(ПутьКФайлу)

    // 1. Универсальное чтение файла в массив байт
    ДанныеФайла = МассивИзФайла(ПутьКФайлу);
    
    // 2. Проверка сигнатуры "BM"
    Если Не (ДанныеФайла[0] = 66 И ДанныеФайла[1] = 77) Тогда // "B" и "M"
        ВызватьИсключение "Это не BMP-файл";
    КонецЕсли;
    
    // 3. Чтение ширины и высоты из заголовка (смещения 18 и 22)
    Ширина = ПрочитатьЦелое32ИзМассива(ДанныеФайла, 18);
    Высота = ПрочитатьЦелое32ИзМассива(ДанныеФайла, 22);
    
    Сообщить("Размер изображения: " + Ширина + " x " + Высота + " пикселей");
    
КонецПроцедуры

 Аналог на 1С 8.3.9+  - используя возможности платформы:

// Работает ТОЛЬКО на платформе 8.3.9+ в подходящем режиме совместимости
Процедура ПрочитатьРазмерыBMP_Платформа(ПутьКФайлу)
    
    Поток = Новый ПотокВФайле(ПутьКФайлу, РежимОткрытияФайла.Чтение);
    
    // Чтение заголовка
    Поток.Пропустить(2); // Пропускаем сигнатуру "BM"
    Поток.Пропустить(12); // Пропускаем размер файла и зарезервированные поля
    СмещениеДанных = Поток.Прочитать(Целое32);
    РазмерЗаголовка = Поток.Прочитать(Целое32);
    Ширина = Поток.Прочитать(Целое32);
    Высота = Поток.Прочитать(Целое32);
    
    Сообщить("Размер изображения: " + Ширина + " x " + Высота + " пикселей");
    Поток.Закрыть();
    
КонецПроцедуры

Обновление от 28.08.2026 - добавил функции со смещением

Добавил новые функции - чтобы было проще переносить функционал 1С 8.3.9 и в обратную сторону.

4. Буферный слой (имитация БуфераДвоичныхДанных) от 28.08.2026 - версия 2.0.

Пример новых функций:

// Создаем буфер из HEX-строки
Буфер = БуферСоздать("0x01020304", "LittleEndian");

// Читаем число (позиция автоматически смещается на 4)
Число = БуферПрочитатьЦелое32(Буфер); // = 0x04030201

// Возвращаем позицию в начало и записываем новое значение
БуферУстановитьПозицию(Буфер, 0);
БуферЗаписатьЦелое32(Буфер, 0x12345678);

// Получаем HEX-дамп для отладки
Сообщить(БуферПолучитьHex(Буфер)); // "78563412"

// Проверяем ошибки
Если БуферЕстьОшибка(Буфер) Тогда
    Сообщить("Ошибка: " + БуферПолучитьОшибку(Буфер));
КонецЕсли;

Для 2.0 характерен принцип - версия 1.0 целиком и полностью сохранена и включена в неё.