URI::Split - Parse and compose URI strings
use URI::Split qw(uri_split uri_join); ($scheme, $auth, $path, $query, $frag) = uri_split($uri); $uri = uri_join($scheme, $auth, $path, $query, $frag);
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
undefvalue 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
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
undeffor 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.
Copyright 2003, Gisle Aas
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.