man IRI (3): Internationalized Resource Identifiers

VERSION

This document describes IRI version 0.005

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.

AUTHOR

Gregory Todd Williams "<[email protected]>"