NAME

       IRI - Internationalized Resource Identifiers

VERSION

       This document describes IRI version 0.011

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.

       "rel ( $base )"
           Returns a new relative IRI object which, when resolved against the $base IRI, is equal to this 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--2018 Gregory Todd Williams. This program is free software; you  can  redistribute  it
       and/or modify it under the same terms as Perl itself.

perl v5.36.0                                       2022-08-28                                           IRI(3pm)