IRI - Internationalized Resource Identifiers
This document describes IRI version 0.007
use IRI; my $i = IRI->new(value => 'https://example.org:80/index#frag'); say $i->scheme; # 'https' say $i->path; # '/index' my $base = IRI->new(value => "http://www.hestebedg\x{e5}rd.dk/"); my $i = IRI->new(value => '#frag', base => $base); say $i->abs; # 'http://www.hestebedgård.dk/#frag' # Defer parsing of the IRI until necessary my $i = IRI->new(value => "http://www.hestebedg\x{e5}rd.dk/", lazy => 1); say $i->path; # path is parsed here
The IRI module provides an object representation for Internationalized Resource Identifiers (IRIs) as defined by RFC 3987 and supports their parsing, serializing, and base resolution.
lazy
A boolean value indicating whether the IRI should be parsed (and validated) during object construction (false), or parsed only when an IRI component is accessed (true). If no components are ever needed (e.g. an IRI is constructed with a value and value is the only accessor ever called), no parsing will take place.
value
as_string
Returns the absolute IRI string resolved against the base IRI, if present; the relative IRI string otherwise.
abs
Returns the absolute IRI string (resolved against the base IRI if present).
scheme
host
port
user
path
fragment
query
Returns the respective component of the parsed IRI.
query_form
Returns a HASH of key-value mappings for the unencoded, parsed query form data.
set_query_param ( $key => $value )
sets the respective query form value and returns a new IRI object.
http://www.ietf.org/rfc/rfc3987.txt
Gregory Todd Williams <gwilliams@cpan.org>
<gwilliams@cpan.org>
Copyright (c) 2014 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install IRI, copy and paste the appropriate command in to your terminal.
cpanm
cpanm IRI
CPAN shell
perl -MCPAN -e shell install IRI
For more information on module installation, please visit the detailed CPAN module installation guide.