1URI::Split(3)         User Contributed Perl Documentation        URI::Split(3)
2
3
4

NAME

6       URI::Split - Parse and compose URI strings
7

SYNOPSIS

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

DESCRIPTION

14       Provides functions to parse and compose URI strings.  The following
15       functions are provided:
16
17       ($scheme, $auth, $path, $query, $frag) = uri_split($uri)
18           Breaks up a URI string into its component parts.  An "undef" value
19           is returned for those parts that are not present.  The $path part
20           is always present (but can be the empty string) and is thus never
21           returned as "undef".
22
23           No sensible value is returned if this function is called in a
24           scalar context.
25
26       $uri = uri_join($scheme, $auth, $path, $query, $frag)
27           Puts together a URI string from its parts.  Missing parts are sig‐
28           naled by passing "undef" for the corresponding argument.
29
30           Minimal escaping is applied to parts that contain reserved chars
31           that would confuse a parser.  For instance, any occurrence of '?'
32           or '#' in $path is always escaped, as it would otherwise be parsed
33           back as a query or fragment.
34

SEE ALSO

36       URI, URI::Escape
37

39       Copyright 2003, Gisle Aas
40
41       This library is free software; you can redistribute it and/or modify it
42       under the same terms as Perl itself.
43
44
45
46perl v5.8.8                       2004-01-14                     URI::Split(3)
Impressum