NAME

       IRI - Internationalized Resource Identifiers

VERSION

       This document describes IRI version 0.008

SYNOPSIS

         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

DESCRIPTION

       The IRI module provides an object representation for Internationalized Resource
       Identifiers (IRIs) as defined by RFC 3987 <http://www.ietf.org/rfc/rfc3987.txt> and
       supports their parsing, serializing, and base resolution.

ATTRIBUTES

       "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.

METHODS

       "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.

SEE ALSO

       <http://www.ietf.org/rfc/rfc3987.txt>

AUTHOR

       Gregory Todd Williams  "<gwilliams@cpan.org>"

COPYRIGHT

       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.