NAME

URL::Encode - Encoding and decoding of application/x-www-form-urlencoded encoding.

SYNOPSIS

    $octets = url_decode($octets);
    $string = url_decode_utf8($octets);
    $octets = url_encode($octets);
    $octets = url_encode_utf8($string);
              url_params_each($octets, $callback [, $utf8 = false]);
    $params = url_params_flat($octets [, $utf8 = false]);
    $params = url_params_mixed($octets [, $utf8 = false]);
    $params = url_params_multi($octets [, $utf8 = false]);

DESCRIPTION

This module provides functions to encode and decode strings into and from the application/x-www-form-urlencoded encoding.

FUNCTIONS

url_decode

Decodes a urlencoded octet string.

Usage

    $octets = url_decode($octets);

url_decode_utf8

Decodes a urlencoded octet string using the UTF-8 encoding scheme.

Usage

    $string = url_decode_utf8($octets);

url_encode

Encodes an octet string into a urlencoded encoding.

Usage

    $octets = url_encode($octets);

url_encode_utf8

Encodes a character string into a urlencoded encoding using the UTF-8 encoding scheme.

Usage

    $octets = url_encode($string);

url_params_each

Decodes a urlencoded data set invoking a callback for each name/value pair.

Usage

    $callback = sub {
        my ($name, $value) = @_;
    };

    url_params_each($octets, $callback);
    url_params_each($octets, $callback, $utf8);

url_params_flat

Decodes a urlencoded data set into an ARRAY reference like:

    [ "name", "value", "name", "value" ]

Usage

    $array = url_params_flat($octets);
    $array = url_params_flat($octets, $utf8);

url_params_mixed

Decodes a urlencoded data set into a HASH reference like:

    { name => "value", name => [ "value", "value" ] }

Usage

    $hash = url_params_mixed($octets);
    $hash = url_params_mixed($octets, $utf8);

url_params_multi

Decodes a urlencoded data set into a HASH reference like:

    { name => [ "value" ], name => [ "value", "value" ] }

Usage

    $hash = url_params_multi($octets);
    $hash = url_params_multi($octets, $utf8);

EXPORTS

None by default. All functions can be exported using the :all tag or individually.

DIAGNOSTICS

(F) Usage: %s

Subroutine called with wrong number of arguments.

(F) Wide character in octet string

(F) Malformed UTF-8 in URL-decoded octets

SEE ALSO

URL::Encode::XS

XS implementation of URL::Encode.

CGI::Deurl::XS

SUPPORT

Please report any bugs or feature requests to bug-url-encode@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=URL-Encode

AUTHOR

Christian Hansen chansen@cpan.org

COPYRIGHT

Copyright 2011 by Christian Hansen.

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

cpanm URL::Encode

perl -MCPAN -e shell
install URL::Encode