=head1 NAME URI::Encode::XS - a Perl URI encoder/decoder using C =head1 SYNOPSIS use URI::Encode::XS qw/uri_encode uri_decode/; my $encoded = uri_encode($data); my $decoded = uri_decode($encoded); =head1 DESCRIPTION This is a Perl URI encoder/decoder written in XS based on L<RFC3986|https://tools.ietf.org/html/rfc3986>. This module always encodes characters that are not unreserved. When decoding, invalid escape sequences are preserved, e.g: uri_decode("foo%20bar%a/"); # foo bar%a/ uri_decode("foo%20bar%a"); # foo bar%a uri_decode("foo%20bar%"); # foo bar% As of version 0.09, the C<bench> script shows it to be significantly faster than C<URI::Escape>: Rate escape encode escape 144165/s -- -98% encode 8239785/s 5616% -- Rate unescape decode unescape 196870/s -- -97% decode 6051468/s 2974% -- However this is just one string - the fewer encoded/decoded characters are in the string, the closer the benchmark is likely to be (see C<bench> for details of the benchmark). Different hardware will yield different results. Another fast encoder/decoder which supports custom escape lists, is L<URI::XSEscape|https://metacpan.org/pod/URI::XSEscape>. =head1 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 =head1 CONTRIBUTORS =over 4 =item * L<Aristotle Pagaltzis|https://github.com/ap> =item * L<Christian Hansen|https://github.com/chansen> =item * L<Jesse DuMond|https://github.com/JesseCanary> =back =head1 SEE ALSO =over 4 =item * L<URI::Escape|https://metacpan.org/pod/URI::Escape> =item * L<URI::XSEscape|https://metacpan.org/pod/URI::XSEscape> =item * L<URL::Encode|https://metacpan.org/pod/URL::Encode> =item * My article about the story of this module: L<The road to a 55x speedup with XS|http://perltricks.com/article/the-road-to-a-55x-speedup-with-xs/> =back =head1 REPOSITORY L<https://github.com/dnmfarrell/URI-Encode-XS> =head1 LICENSE See LICENSE =head1 AUTHOR E<copy> 2016 David Farrell =cut