NAME

URI::Encode::XS - a Perl URI encoder/decoder using C

SYNOPSIS

use URI::Encode::XS qw/uri_encode uri_decode/;

my $encoded = uri_encode($data);
my $decoded = uri_decode($encoded);

DESCRIPTION

This is a Perl module that wraps my C URI encoder/decoder based on RFC3986. This module always encodes characters that are not unreserved.

I've benchmarked it and found it significantly faster than URI::Escape at encoding and decoding:

Rate escape encode
escape  130275/s     --   -96%
encode 3581667/s  2649%     --
  Rate unescape   decode
unescape  189434/s       --     -96%
decode   5161471/s    2625%       --

However this is just one string - the fewer encoded/decoded characters are in the string, the closer the benchmark is likely to be (see bench for details of the benchmark). Different hardware will yield different results.

Another fast encoder/decoder which supports custom escape lists, is URI::XSEscape.

INSTALLATION

$ cpan URI::Encode::XS

Or

$ git clone https://github.com/dnmfarrell/URI-Encode-XS
$ cd URI-Encode-XS
$ perl Makefile.PL
$ make
$ make test
$ make install

THANKS

Thanks to Jesse DuMond for helping optimize the C code.

REPOSITORY

https://github.com/dnmfarrell/URI-Encode-XS

LICENSE

See LICENSE

AUTHOR

© 2016 David Farrell