mime::decoder::base64(3pm) [debian man page]

MIME::Decoder::Base64(3pm)				User Contributed Perl Documentation				MIME::Decoder::Base64(3pm)

NAME

       MIME::Decoder::Base64 - encode/decode a "base64" stream

SYNOPSIS

       A generic decoder object; see MIME::Decoder for usage.

DESCRIPTION

       A MIME::Decoder subclass for the "base64" encoding.  The name was chosen to jibe with the pre-existing MIME::Base64 utility package, which
       this class actually uses to translate each chunk.

       o   When decoding, the input is read one line at a time.  The input accumulates in an internal buffer, which is decoded in
	   multiple-of-4-sized chunks (plus a possible "leftover" input chunk, of course).

       o   When encoding, the input is read 45 bytes at a time: this ensures that the output lines are not too long.   We chose 45 since it is a
	   multiple of 3 and produces lines under 76 characters, as RFC 2045 specifies:
	       The encoded output stream must be represented in lines of no more
	       than 76 characters each.

SEE ALSO

       MIME::Decoder

AUTHOR

       Eryq (eryq@zeegee.com), ZeeGee Software Inc (http://www.zeegee.com).

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

perl v5.14.2							    2012-06-08						MIME::Decoder::Base64(3pm)

MIME::Base64::URLSafe(3pm)				User Contributed Perl Documentation				MIME::Base64::URLSafe(3pm)

NAME

       MIME::Base64::URLSafe - Perl version of Python's URL-safe base64 codec

SYNOPSIS

	 use MIME::Base64::URLSafe;

	 $encoded = urlsafe_b64encode('Alladdin: open sesame');
	 $decoded = urlsafe_b64decode($encoded);

DESCRIPTION

       This module is a perl version of python's URL-safe base64 encoder / decoder.

       When embedding binary data in URL, it is preferable to use base64 encoding.  However, two characters ('+' and '/') used in the standard
       base64 encoding have special meanings in URLs, often leading to re-encoding with URL-encoding, or worse, interoperability problems.

       To overcome the problem, the module provides a variation of base64 codec compatible with python's urlsafe_b64encode / urlsafe_b64decode.

       Modification rules from base64:

	   use '-' and '_' instead of '+' and '/'
	   no line feeds
	   no trailing equals (=)

       The following functions are provided:

	   urlsafe_b64encode($str)
	   urlsafe_b64decode($str)

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

	   use MIME::Base64::URLSafe ();
	   $encoded = MIME::Base64::URLSafe::encode($decoded);
	   $decoded = MIME::Base64::URLSafe::decode($encoded);

SEE ALSO

       MIME::Base64

       Fore more discussion on using base64 encoding in URL applications, see: http://en.wikipedia.org/wiki/Base64#URL_Applications

AUTHOR

       Kazuho Oku <kazuho ___at___ labs.cybozu.co.jp>

       Copyright (C) 2006 Cybozu Labs, Inc.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.7 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.8.8							    2006-01-05						MIME::Base64::URLSafe(3pm)