manpagez: man pages & more
man URI::Split(3)
Home | html | info | man
URI::Split(3)         User Contributed Perl Documentation        URI::Split(3)




NAME

       URI::Split - Parse and compose URI strings


SYNOPSIS

        use URI::Split qw(uri_split uri_join);
        ($scheme, $auth, $path, $query, $frag) = uri_split($uri);
        $uri = uri_join($scheme, $auth, $path, $query, $frag);


DESCRIPTION

       Provides functions to parse and compose URI strings.  The following
       functions are provided:

       ($scheme, $auth, $path, $query, $frag) = uri_split($uri)
           Breaks up a URI string into its component parts.  An "undef" value
           is returned for those parts that are not present.  The $path part
           is always present (but can be the empty string) and is thus never
           returned as "undef".

           No sensible value is returned if this function is called in a
           scalar context.

       $uri = uri_join($scheme, $auth, $path, $query, $frag)
           Puts together a URI string from its parts.  Missing parts are
           signaled by passing "undef" for the corresponding argument.

           Minimal escaping is applied to parts that contain reserved chars
           that would confuse a parser.  For instance, any occurrence of '?'
           or '#' in $path is always escaped, as it would otherwise be parsed
           back as a query or fragment.


SEE ALSO

       URI(3), URI::Escape(3)


COPYRIGHT

       Copyright 2003, Gisle Aas

       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.



perl v5.16.3                      2014-11-05                     URI::Split(3)

uri 1.650.0 - Generated Mon Jan 19 08:39:17 CST 2015
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.