Perl 5 version 8.0 documentation

MIME::QuotedPrint

NAME

MIME::QuotedPrint - Encoding and decoding of quoted-printable strings

SYNOPSIS

  1. use MIME::QuotedPrint;
  2. $encoded = encode_qp($decoded);
  3. $decoded = decode_qp($encoded);

DESCRIPTION

This module provides functions to encode and decode strings into the Quoted-Printable encoding specified in RFC 2045 - MIME (Multipurpose Internet Mail Extensions). The Quoted-Printable encoding is intended to represent data that largely consists of bytes that correspond to printable characters in the ASCII character set. Non-printable characters (as defined by english americans) are represented by a triplet consisting of the character "=" followed by two hexadecimal digits.

The following functions are provided:

  • encode_qp($str)

    This function will return an encoded version of the string given as argument.

    Note that encode_qp() does not change newlines "\n" to the CRLF sequence even though this might be considered the right thing to do (RFC 2045 (Q-P Rule #4)).

  • decode_qp($str);

    This function will return the plain text version of the string given as argument.

If you prefer not to import these routines into your namespace you can call them as:

  1. use MIME::QuotedPrint ();
  2. $encoded = MIME::QuotedPrint::encode($decoded);
  3. $decoded = MIME::QuotedPrint::decode($encoded);

COPYRIGHT

Copyright 1995-1997 Gisle Aas.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.