NAME
MarpaX::ESLIF::URI - URI as per RFC3986/RFC6874
VERSION
version 0.007
SYNOPSIS
use feature 'say';
use Data::Dumper;
use MarpaX::ESLIF::URI;
my $http_url = "http://[2001:db8:a0b:12f0::1%25Eth0]:80/index.html";
my $http_uri = MarpaX::ESLIF::URI->new($http_url);
say $http_uri->scheme; # http
say $http_uri->host; # [2001:db8:a0b:12f0::1%Eth0]
say $http_uri->hostname; # 2001:db8:a0b:12f0::1%Eth0
say $http_uri->path; # /index.html
say $http_uri->ip; # 2001:db8:a0b:12f0::1%Eth0
say $http_uri->ipv6; # 2001:db8:a0b:12f0::1
say $http_uri->zone; # Eth0
my $file_url = "file:/c|/path/to/file";
my $file_uri = MarpaX::ESLIF::URI->new($file_url);
say $file_uri->scheme; # file
say $file_uri->string; # file:/c|/path/to/file
say $file_uri->drive; # c
say $file_uri->path; # /c|/path/to/file
say Dumper($file_uri->segments); # [ 'c|', 'path', 'to', 'file' ]
my $mail_url = "mailto:bogus\@email.com,bogus2\@email.com?"
. "subject=test%20subject&"
. "body=This%20is%20the%20body%20of%20this%20message.";
my $mail_uri = MarpaX::ESLIF::URI->new($mail_url);
say $mail_uri->scheme; # mailto
say Dumper($mail_uri->to); # bogus\@email.com, bogus2\@email.com
say Dumper($mail_uri->headers); # { 'subject' => 'test subject', 'body' => 'This is the body of this message.' }
SUBROUTINES/METHODS
$class->new($str, $scheme)
Returns a instance that is a MarpaX::ESLIF::URI::$scheme representation of $str
, when $scheme
defaults to _generic
if there is no specific $scheme
implementation, or if the later fails.
All methods of MarpaX::ESLIF::URI::_generic are available, sometimes extended or modified by specific scheme implementations.
NOTES
Percent-encoded characters are decoded to ASCII characters corresponding to every percent-encoded byte.
SEE ALSO
MarpaX::ESLIF::URI::_generic, MarpaX::ESLIF::URI::file, MarpaX::ESLIF::URI::ftp, MarpaX::ESLIF::URI::http, MarpaX::ESLIF::URI::https, MarpaX::ESLIF::URI::mailto, MarpaX::ESLIF::URI::tag, MarpaX::ESLIF::URI::tel.
AUTHOR
Jean-Damien Durand <jeandamiendurand@free.fr>
CONTRIBUTOR
Jean-Damien Durand <Jean-Damien.Durand@newaccess.ch>
COPYRIGHT AND LICENSE
This software is copyright (c) 2017 by Jean-Damien Durand.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.