dwww Home | Manual pages | Find package

URI::Split(3pm)       User Contributed Perl Documentation       URI::Split(3pm)

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, URI::Escape

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.38.2                       2024-10-09                   URI::Split(3pm)

Generated by dwww version 1.16 on Tue Dec 16 05:50:53 CET 2025.