package MIME::QuotedPrint;
-# $Id: QuotedPrint.pm,v 3.1 2004/03/29 11:55:49 gisle Exp $
+# $Id: QuotedPrint.pm,v 3.3 2004/08/24 16:22:27 gisle Exp $
use strict;
use vars qw(@ISA @EXPORT $VERSION);
=item encode_qp($str, $eol)
-This function returns an encoded version of the string given as
-argument.
+=item encode_qp($str, $eol, $binmode)
-The second argument is the line-ending sequence to use. It is
-optional and defaults to "\n". Every occurrence of "\n" is
-replaced with this string, and it is also used for additional
-"soft line breaks" to ensure that no line is longer than 76
-characters. You might want to pass it as "\015\012" to produce data
-suitable for external consumption. The string "\r\n" produces the
-same result on many platforms, but not all.
+This function returns an encoded version of the string ($str) given as
+argument.
-An $eol of "" (the empty string) is special. In this case, no "soft line breaks" are introduced
-and any literal "\n" in the original data is encoded as well.
+The second argument ($eol) is the line-ending sequence to use. It is
+optional and defaults to "\n". Every occurrence of "\n" is replaced
+with this string, and it is also used for additional "soft line
+breaks" to ensure that no line end up longer than 76 characters. Pass
+it as "\015\012" to produce data suitable for external consumption.
+The string "\r\n" produces the same result on many platforms, but not
+all.
+
+The third argument ($binmode) will select binary mode if passed as a
+TRUE value. In binary mode "\n" will be encoded in the same way as
+any other non-printable character. This ensures that a decoder will
+end up with exactly the same string whatever line ending sequence it
+uses. In general it is preferable to use the base64 encoding for
+binary data; see L<MIME::Base64>.
+
+An $eol of "" (the empty string) is special. In this case, no "soft
+line breaks" are introduced and binary mode is effectively enabled so
+that any "\n" in the original data is encoded as well.
=item decode_qp($str);
@tests =
(
# plain ascii should not be encoded
+ ["", ""],
["quoted printable" =>
- "quoted printable"],
+ "quoted printable=\n"],
# 8-bit chars should be encoded
["v\xe5re kj\xe6re norske tegn b\xf8r \xe6res" =>
- "v=E5re kj=E6re norske tegn b=F8r =E6res"],
+ "v=E5re kj=E6re norske tegn b=F8r =E6res=\n"],
# trailing space should be encoded
- [" " => "=20=20"],
- ["\tt\t" => "\tt=09"],
+ [" " => "=20=20=\n"],
+ ["\tt\t" => "\tt=09=\n"],
["test \ntest\n\t \t \n" => "test=20=20\ntest\n=09=20=09=20\n"],
# "=" is special an should be decoded
["=30\n" => "=3D30\n"],
- ["\0\xff0" => "=00=FF0"],
+ ["\0\xff0" => "=00=FF0=\n"],
# Very long lines should be broken (not more than 76 chars
["The Quoted-Printable encoding is intended to represent data that largly consists of octets that correspond to printable characters in the ASCII character set." =>
"The Quoted-Printable encoding is intended to represent data that largly con=
sists of octets that correspond to printable characters in the ASCII charac=
-ter set."
+ter set.=\n"
],
# Long lines after short lines were broken through 2.01.
In America, any boy may become president and I suppose that's just one of the risks he takes. -- Adlai Stevenson" =>
"short line
In America, any boy may become president and I suppose that's just one of t=
-he risks he takes. -- Adlai Stevenson"],
+he risks he takes. -- Adlai Stevenson=\n"],
# My (roderick@argon.org) first crack at fixing that bug failed for
# multiple long lines.
lty played instead of the students, and even more interesting if the
trustees played. There would be a great increase in broken arms, legs, and=
necks, and simultaneously an appreciable diminution in the loss to humanit=
-y. -- H. L. Mencken"],
+y. -- H. L. Mencken=\n"],
# Don't break a line that's near but not over 76 chars.
- ["$x70!23" => "$x70!23"],
- ["$x70!234" => "$x70!234"],
- ["$x70!2345" => "$x70!2345"],
- ["$x70!23456" => "$x70!23456"],
- ["$x70!234567" => "$x70!2345=\n67"],
- ["$x70!23456=" => "$x70!2345=\n6=3D"],
+ ["$x70!23" => "$x70!23=\n"],
+ ["$x70!234" => "$x70!234=\n"],
+ ["$x70!2345" => "$x70!2345=\n"],
+ ["$x70!23456" => "$x70!23456=\n"],
+ ["$x70!234567" => "$x70!2345=\n67=\n"],
+ ["$x70!23456=" => "$x70!2345=\n6=3D=\n"],
["$x70!23\n" => "$x70!23\n"],
["$x70!234\n" => "$x70!234\n"],
["$x70!2345\n" => "$x70!2345\n"],
["$x70!23456=\n" => "$x70!2345=\n6=3D\n"],
# Not allowed to break =XX escapes using soft line break
- ["$x70===xxxxx" => "$x70=3D=\n=3D=3Dxxxxx"],
- ["$x70!===xxxx" => "$x70!=3D=\n=3D=3Dxxxx"],
- ["$x70!2===xxx" => "$x70!2=3D=\n=3D=3Dxxx"],
- ["$x70!23===xx" => "$x70!23=\n=3D=3D=3Dxx"],
- ["$x70!234===x" => "$x70!234=\n=3D=3D=3Dx"],
+ ["$x70===xxxxx" => "$x70=3D=\n=3D=3Dxxxxx=\n"],
+ ["$x70!===xxxx" => "$x70!=3D=\n=3D=3Dxxxx=\n"],
+ ["$x70!2===xxx" => "$x70!2=3D=\n=3D=3Dxxx=\n"],
+ ["$x70!23===xx" => "$x70!23=\n=3D=3D=3Dxx=\n"],
+ ["$x70!234===x" => "$x70!234=\n=3D=3D=3Dx=\n"],
["$x70!2=\n" => "$x70!2=3D\n"],
["$x70!23=\n" => "$x70!23=\n=3D\n"],
["$x70!234=\n" => "$x70!234=\n=3D\n"],
# line width
# some extra special cases we have had problems with
- ["$x70!2=x=x" => "$x70!2=3D=\nx=3Dx"],
+ ["$x70!2=x=x" => "$x70!2=3D=\nx=3Dx=\n"],
["$x70!2345$x70!2345$x70!23456\n", "$x70!2345=\n$x70!2345=\n$x70!23456\n"],
# trailing whitespace
- ["foo \t ", "foo=20=09=20"],
- ["foo\t \n \t", "foo=09=20\n=20=09"],
+ ["foo \t ", "foo=20=09=20=\n"],
+ ["foo\t \n \t", "foo=09=20\n=20=09=\n"],
);
-$notests = @tests + 13;
+$notests = @tests + 16;
print "1..$notests\n";
$testno = 0;
print "not " unless encode_qp("$x70!2345$x70\n", "") eq "$x70!2345$x70=0A";
$testno++; print "ok $testno\n";
+# Test binary encoding
+print "not " unless encode_qp("foo", undef, 1) eq "foo=\n";
+$testno++; print "ok $testno\n";
+
+print "not " unless encode_qp("foo\nbar\r\n", undef, 1) eq "foo=0Abar=0D=0A=\n";
+$testno++; print "ok $testno\n";
+
+print "not " unless encode_qp(join("", map chr, 0..255), undef, 1) eq <<'EOT'; $testno++; print "ok $testno\n";
+=00=01=02=03=04=05=06=07=08=09=0A=0B=0C=0D=0E=0F=10=11=12=13=14=15=16=17=18=
+=19=1A=1B=1C=1D=1E=1F !"#$%&'()*+,-./0123456789:;<=3D>?@ABCDEFGHIJKLMNOPQRS=
+TUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~=7F=80=81=82=83=84=85=86=87=88=
+=89=8A=8B=8C=8D=8E=8F=90=91=92=93=94=95=96=97=98=99=9A=9B=9C=9D=9E=9F=A0=A1=
+=A2=A3=A4=A5=A6=A7=A8=A9=AA=AB=AC=AD=AE=AF=B0=B1=B2=B3=B4=B5=B6=B7=B8=B9=BA=
+=BB=BC=BD=BE=BF=C0=C1=C2=C3=C4=C5=C6=C7=C8=C9=CA=CB=CC=CD=CE=CF=D0=D1=D2=D3=
+=D4=D5=D6=D7=D8=D9=DA=DB=DC=DD=DE=DF=E0=E1=E2=E3=E4=E5=E6=E7=E8=E9=EA=EB=EC=
+=ED=EE=EF=F0=F1=F2=F3=F4=F5=F6=F7=F8=F9=FA=FB=FC=FD=FE=FF=
+EOT
+
print "not " if $] >= 5.006 && (eval 'encode_qp("XXX \x{100}")' || !$@);
$testno++; print "ok $testno\n";
projects / p5sagit/p5-mst-13.2.git / commitdiff