Кодирование и форматы

Кодирование меняет представление данных, но не скрывает их. Все функции ниже используют общую запись функций in-Line.

Что выбрать

Текст, байты и печатное представление

Одна и та же видимая строка может означать разные данные. Перед выбором функции определите, что находится на входе.

BASE64DECODE и BASEENCODEDECODE после восстановления байтов пытаются получить текст. BASE64TOHEX этого не делает: она сохраняет каждый байт и меняет только алфавит записи.

Простая пара Base64

(|BASE64|demo|BASE64|)

ZGVtbw==

Полный безопасный пример с промежуточной переменной:

#beginScript
|DV|[encoded] = (|BASE64|demo|BASE64|)
|DV|[decoded] = (|BASE64DECODE||DV|[encoded]|BASE64DECODE|)
#endScript

После выполнения |DV|[encoded] равно ZGVtbw==, а |DV|[decoded] — demo. Основные алфавиты Base16, Base32 и Base64 определены в стандарте RFC 4648.

Значение строки JSON: ESCJSON

ESCJSON превращает произвольный текст во внутреннее содержимое строки JSON. Она экранирует кавычки, обратные косые черты, переводы строк, табуляцию и другие управляющие символы, но не добавляет внешние кавычки.

(|ESCJSON|Бренд "North Wind"|ESCJSON|)

Результат:

Бренд \"North Wind\"

Функцию нужно ставить внутрь уже существующих кавычек значения:

{
  "brand": "(|ESCJSON||PARS|[1]|ESCJSON|)",
  "inStock": true
}

Если |PARS|[1] равно Бренд "North Wind", после подстановки объект остаётся корректным JSON, а значение поля при разборе снова станет исходным текстом.

Значение в адресе: URLENCODE и URLDECODE

(|URLENCODE|q=Data Export&lang=ru|URLENCODE|)

q%3DData%20Export%26lang%3Dru

https://example.com/search?q=(|URLENCODE|Data Export|URLENCODE|)

Последовательности Unicode: UNICODEDECODE

UNICODEDECODE заменяет каждую последовательность \uXXXX соответствующим элементом UTF-16.

(|UNICODEDECODE|\u041f\u0440\u0438\u0432\u0435\u0442|UNICODEDECODE|)

Результат:

Привет

Символы за пределами основной многоязычной плоскости требуют правильной суррогатной пары:

(|UNICODEDECODE|🚀|UNICODEDECODE|)

Результат — 🚀. Неполные последовательности, неверные шестнадцатеричные цифры, одиночный верхний или нижний суррогат завершают выполнение явной ошибкой с позицией.

Чтобы оставить последовательность обычным текстом, удвойте обратную косую черту:

(|UNICODEDECODE|\\u041f|UNICODEDECODE|)

Результат — буквальный текст \u041f. Обратные косые черты перед другими буквами не изменяются.

Исправление ANSI-строки: ANSITOUTF8

ANSITOUTF8 предназначена для строки, которую прочитали через системную кодировку ANSI и из-за этого показали искажённо.

(|ANSITOUTF8|Êàòàëîã òîâàðîâ|ANSITOUTF8|)

На системе с русской кодовой страницей результат:

Каталог товаров

Преобразование зависит от текущей кодовой страницы Windows. Если полученная строка пуста или содержит знак замены �, функция возвращает исходный текст вместо ошибки.

Файл по адресу: FILETOBASE64

FILETOBASE64 выполняет вложенные значения в адресе, отправляет запрос GET через текущую прокси и кодирует сырые байты тела ответа в Base64.

(|FILETOBASE64|https://example.com/|FILETOBASE64|)

Результатом будет одна строка Base64 с текущим содержимым ответа. Функция не пытается распознать изображение, архив или текст: одинаково обрабатываются любые байты.

HTTP-ответ с телом кодируется как получен. Если прикладной сервер вместо файла вернул страницу ошибки, её байты также могут стать корректной строкой Base64, поэтому проверяйте состояние сетевого запроса до вызова или используйте адрес с однозначным договором.

Между Base64 и шестнадцатеричной формой

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

(|HEXTOBASE64|A8|HEXTOBASE64|)

qA==

Проверочная пара для нескольких байтов:

#beginScript
|DV|[asBase64] = (|HEXTOBASE64|64656D6F|HEXTOBASE64|)
|DV|[asHex] = (|BASE64TOHEX||DV|[asBase64]|BASE64TOHEX|)
#endScript

Результаты: |DV|[asBase64] равно ZGVtbw==, |DV|[asHex] равно 64656D6F.

Несколько алфавитов: BASEENCODEDECODE

BASEENCODEDECODE принимает один объект JSON, кодирует текст или декодирует печатную строку выбранным алгоритмом.

(|BASEENCODEDECODE|{"algorithm":"Base64","action":"encode","message":"demo"}|BASEENCODEDECODE|)

Результат:

ZGVtbw==

Поля объекта

Ключи, действия и имена алгоритмов чувствительны к регистру. Не заключайте логическое значение в кавычки:

(|BASEENCODEDECODE|{"algorithm":"Base64","action":"encode","message":"demo","usePadding":false}|BASEENCODEDECODE|)

Результат — ZGVtbw без ==.

Доступные алгоритмы

Значения из переменных

Весь объект сначала проходит обычные подстановки in-Line. Если значение может содержать кавычку, обратную косую черту или перевод строки, подготовьте его через ESCJSON:

(|BASEENCODEDECODE|{"algorithm":"Base64","action":"encode","message":"(|ESCJSON||PARS|[1]|ESCJSON|)"}|BASEENCODEDECODE|)

Без ESCJSON значение Товар "A" разорвёт кавычки объекта ещё до его разбора.

Обратное преобразование и ошибки

(|BASEENCODEDECODE|{"algorithm":"Base64","action":"decode","message":"ZGVtbw"}|BASEENCODEDECODE|)

Результат — demo: ветвь Base64 принимает форму для адресов и дополняет отсутствующие =.

После декодирования любого алгоритма байты читаются как UTF-8. Если исходные байты не являются корректным текстом UTF-8, результат нельзя использовать как надёжное двоичное значение; для сохранения байтов в другой печатной форме используйте BASE64TOHEX или HEXTOBASE64.