NAME
Mojo::Util - Portable utility functions
SYNOPSIS
use Mojo::Util qw/b64_encode url_escape url_unescape/;
my $string = 'test=23';
my $escaped = url_escape $string;
say url_unescape $escaped;
say b64_encode $escaped, '';
DESCRIPTION
Mojo::Util provides portable utility functions for Mojo.
FUNCTIONS
Mojo::Util implements the following functions.
b64_decode
my $string = b64_decode $b64;
Base64 decode string.
b64_encode
my $b64 = b64_encode $string;
my $b64 = b64_encode $string, "\n";
Base64 encode string, the line ending defaults to a newline.
camelize
my $camelcase = camelize $snakecase;
Convert snake case string to camel case and replace -
with ::
.
# "FooBar"
camelize 'foo_bar';
# "FooBar::Baz"
camelize 'foo_bar-baz';
# "FooBar::Baz"
camelize 'FooBar::Baz';
decamelize
my $snakecase = decamelize $camelcase;
Convert camel case string to snake case and replace ::
with -
.
# "foo_bar"
decamelize 'FooBar';
# "foo_bar-baz"
decamelize 'FooBar::Baz';
# "foo_bar-baz"
decamelize 'foo_bar-baz';
decode
my $chars = decode 'UTF-8', $bytes;
Decode bytes to characters.
encode
my $bytes = encode 'UTF-8', $chars;
Encode characters to bytes.
get_line
my $line = get_line \$string;
Extract whole line from string or return undef
. Lines are expected to end with 0x0d 0x0a
or 0x0a
.
hmac_md5_sum
my $checksum = hmac_md5_sum $string, 'passw0rd';
Generate HMAC-MD5 checksum for string.
hmac_sha1_sum
my $checksum = hmac_sha1_sum $string, 'passw0rd';
Generate HMAC-SHA1 checksum for string.
html_escape
my $escaped = html_escape $string;
my $escaped = html_escape $string, '^\n\r\t !\#\$%\(-;=?-~';
Escape unsafe characters in string with HTML5 entities, the pattern used defaults to ^\n\r\t !\#\$%\(-;=?-~
.
html_unescape
my $string = html_unescape $escaped;
Unescape all HTML5 entities in string.
md5_bytes
my $checksum = md5_bytes $string;
Generate binary MD5 checksum for string.
md5_sum
my $checksum = md5_sum $string;
Generate MD5 checksum for string.
punycode_decode
my $string = punycode_decode $punycode;
Punycode decode string.
punycode_encode
my $punycode = punycode_encode $string;
Punycode encode string.
quote
my $quoted = quote $string;
Quote string.
qp_decode
my $string = qp_decode $qp;
Quoted Printable decode string.
qp_encode
my $qp = qp_encode $string;
Quoted Printable encode string.
secure_compare
my $success = secure_compare $string1, $string2;
Constant time comparison algorithm to prevent timing attacks.
sha1_bytes
my $checksum = sha1_bytes $string;
Generate binary SHA1 checksum for string.
sha1_sum
my $checksum = sha1_sum $string;
Generate SHA1 checksum for string.
trim
my $trimmed = trim $string;
Trim whitespace characters from both ends of string.
unquote
my $string = unquote $quoted;
Unquote string.
url_escape
my $escaped = url_escape $string;
my $escaped = url_escape $string, '^A-Za-z0-9\-\.\_\~';
Percent-encode unsafe characters in string, the pattern used defaults to ^A-Za-z0-9\-\.\_\~
.
url_unescape
my $string = url_unescape $escaped;
Decode percent-encoded characters in string.
xml_escape
my $escaped = xml_escape $string;
Escape only the characters &
, <
, >
, "
and '
in string, this is a much faster version of html_escape
.