Кодирование Base 64

Код Base 64 используется в электронной почте для кодирования последовательности байтов 8-битной длины в виде более длинной последовательности графических символов ASCII. Он определен в интернет-RFC¹⁹2045 и также в RFC 4648. В этом разделе описаны функции для преобразования в этот код и из него.

Команда: base64-encode-region beg end &optional no-line-break

Эта функция преобразует область от beg до end в код Base 64. Она возвращает длину закодированного текста. Ошибка сигнализируется, если символ в области является многобайтовым, то есть в многобайтовой буферизации область должна содержать только символы из наборов символов ascii, eight-bit-control и eight-bit-graphic.

Обычно эта функция вставляет символы новой строки в закодированный текст, чтобы избежать слишком длинных строк. Однако, если необязательный аргумент no-line-break имеет ненулевое значение, эти новые строки не добавляются, поэтому вывод представляет собой одну длинную строку.

Команда: base64url-encode-region beg end &optional no-pad

Эта функция похожа на base64-encode-region, но реализует вариант кодирования Base 64 для URL в соответствии с RFC 4648, и не вставляет символы новой строки в закодированный текст, поэтому вывод представляет собой одну длинную строку.

Если необязательный аргумент no-pad имеет ненулевое значение, то эта функция не генерирует заполнение (=).

Функция: base64-encode-string string &optional no-line-break

Эта функция преобразует строку string в код Base 64. Она возвращает строку, содержащую закодированный текст. Как и в случае с base64-encode-region, ошибка сигнализируется, если символ в строке является многобайтовым.

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

Функция: base64url-encode-string string &optional no-pad

Подобно base64-encode-string, но генерирует вариант Base 64 для URL и не вставляет символы новой строки в закодированный текст, поэтому результат представляет собой одну длинную строку.

Если необязательный аргумент no-pad имеет ненулевое значение, то эта функция не генерирует заполнение.

Команда: base64-decode-region beg end &optional base64url

Эта функция преобразует область от beg до end из кода Base 64 в соответствующий декодированный текст. Она возвращает длину декодированного текста.

Функции декодирования игнорируют символы новой строки в закодированном тексте.

Если необязательный аргумент base64url имеет ненулевое значение, то заполнение является необязательным, и используется вариант Base 64 кодирования для URL.

Функция: base64-decode-string string &optional base64url

Эта функция преобразует строку string из кода Base 64 в соответствующий декодированный текст. Она возвращает строку с одним байтом, содержащую декодированный текст.

Функции декодирования игнорируют символы новой строки в закодированном тексте.

Если необязательный аргумент base64url имеет ненулевое значение, то заполнение является необязательным, и используется вариант Base 64 кодирования для URL.