Работа с Quoted-Printable строками на Ассемблере

Механизм конвертации Quoted-Printable предназначен для представления данных, в основном состоящих из байтов, соответствующих символам, имеющим изображение в символьном наборе ASCII. Если конвертируемые данные в основном представляют собой ASCII-текст, то конечная их форма остается узнаваемой и читаемой для человека. Как правило, такое кодирование используется при передаче бинарных данных или текстов в различных кодировках через электронную почту. Сообщение, полностью состоящее из ASCII-символов, также может быть конвертировано в Quoted-Printable, что гарантирует его содержимому целостность при прохождении через всякие шлюзы, в которых происходит языковая перекодировка символов или преобразование концов строк и т.д. В результате данного кодирования все байты сообщения будут иметь такие значения, которые в дальнейшем не будут модифицированы почтовым транспортом.

Согласно спецификации, в Quoted-Printable байты должны быть представлены в соответствии со следующими правилами:

• Каждый байт, кроме тех, которые используются для обозначения конца строки, может быть представлен с помощью двух шестнадцатеричных цифр, предваряемых знаком "=". При написании шестнадцатеричных цифр с A по F должны использоваться заглавные буквы. Кроме тех случаев, когда нижеследующие правила позволяют альтернативное кодирование, данное правило является обязательным.
  
  
• Байты с десятичным значением с 33 по 60 и с 62 по 126 МОГУТ быть представлены ASCII-символами, соответствующими этим значениям (с '!' по '<' и с '>' по '~').
  
  
• Пробел в кодированной строке может быть заменен на символ подчеркивания "_".
  
  
• Байты со значениями 9 и 32 МОГУТ быть представлены как ASCII-символы "Табуляция" и "Пробел", но НЕ ДОЛЖНЫ быть представлены так в конце строки. Везде, где они представлены соответствующими ASCII-символами, за ними должен следовать символ, имеющий графическое изображение (печатный символ). В конце же строки символы табуляции и пробела должны быть представлены в соответствии с правилом #1, так как некоторые почтовые транспорты могут убирать пробелы в конце строки.
  
  
• Конец строки в тексте письма должен быть представлен (в соответствии с RFC 822) последовательностью CRLF. Так как в каноническом представлении текста не требуется визуального отображения символов конца строки, в Quoted-Printable не используется видимых символов для обозначения конца строки.
  
  
• В соответствии со спецификацией Quoted-Printable, длина строки не должна превышать 76 символов. В противном случае используется "мягкий" перевод строки, представимый знаком равенства. Например, если исходная строка имела вид:
  
  Если программист в девять утра уже на работе, значит он там же и ночевал.

  то в Quoted-Printable encoding он может быть представлена следующим образом:
  
  Если программист в девять утра =
уже на работе, значит =
он там же и ночевал.

  Это обеспечивает механизм восстановления исходной длины строки пользовательским почтовым агентом.

Для решения некоторых своих задач я написал на Ассемблере две функции - для кодирования произвольной строки по правилам Quoted-Printable и раскодирования Quoted-Printable данных. При этом, если данные не в точности соответствуют спецификации, то функция раскодирования старается максимально корректно их восстановить.

Функция Quoted-Printable-декодирования принимает в качестве параметров три значения: указатель на исходную строку, длина исходной строки и указатель на буфер-приемник для раскодированной строки.Исходная строка может в точности соответствовать спецификации Quoted-Printable, но может и отличаться. В этом случае все последовательности символов, подходящие под формат Quoted-Printable, в том числе и мягкие переносы, будут перекодированы, а все остальные символы скопированы без изменений. Размер буфера-приемника не проверяется, поэтому он должен быть не менее длины исходной строки с учетом завершающего нулевого символа (признак окончания строки).

Функция кодирования Quoted-Printable принимает четыре параметра: указатель на исходную строку, длина исходной строки, указатель на буфер-приемник для закодированной строки и максимальная длина строки, после которой будет записываться символ мягкого переноса. Если мягкие переносы использовать не требуется, этот параметр должен быть равен -1.При кодировании все символы без исключения переводятся в Quoted-Printable представление. Размер буфера для приема кодированной строки не проверяется и должен заранее определяться с тем расчетом, что каждый символ исходной строки преобразуется в три закодированных символа плюс запас для трехбайтных последовательностей мягкого переноса (если задано параметром кодирования) и нулевого символа окончания строки.

В приложении примеры двух программ с исходными текстами, демонстрирующие функции Quoted-Printable кодирования и декодирования текстовых строк.

Комментарии

Добавить комментарий

Для вставки цитаты выделите текст и нажмите сюда

Имя*:

Текст комментария (не более 2000 символов)*:

*Все поля обязательны для заполнения.

Комментарии, содержащие рекламу, ненормативную лексику, оскорбления и т.п., а также флуд и сообщения не по теме, будут удаляться. Нарушителям может быть заблокирован доступ к сайту.