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

The URI::Split module provide functions to parse and compose URI strings. The following functions are provided:

($scheme, $auth, $path, $query, $frag) = uri_split($uri)

The uri_split() function will break up a URI string into it component parts. An undef value is returned for those parts that are not present. The $path part will always be present (but can be the empty string) and will thus never be returned as undef.

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

$uri = uri_join($scheme, $auth, $path, $query, $frag)

The uri_join() function will put together a URI string from its parts. Missing parts are signaled by passing undef for the corresponding argument.

Minimal escaping will be applied to parts that contain reserved chars that would confuse a parser. For instance any occurence of '?' or '#' in $path will always be escaped as they would otherwise be parsed back as 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.