SWAMPy

✎ CARVE FLESH

EDITING: Split.pm

package URI::Split;

use strict;
use warnings;

our $VERSION = '5.27';

use Exporter 5.57 'import';
our @EXPORT_OK = qw(uri_split uri_join);

use URI::Escape ();

sub uri_split {
     return $_[0] =~ m,(?:([^:/?#]+):)?(?://([^/?#]*))?([^?#]*)(?:\?([^#]*))?(?:#(.*))?,;
}

sub uri_join {
    my($scheme, $auth, $path, $query, $frag) = @_;
    my $uri = defined($scheme) ? "$scheme:" : "";
    $path = "" unless defined $path;
    if (defined $auth) {
	$auth =~ s,([/?\#]), URI::Escape::escape_char($1),eg;
	$uri .= "//$auth";
	$path = "/$path" if length($path) && $path !~ m,^/,;
    }
    elsif ($path =~ m,^//,) {
	$uri .= "//";  # XXX force empty auth
    }
    unless (length $uri) {
	$path =~ s,(:), URI::Escape::escape_char($1),e while $path =~ m,^[^:/?\#]+:,;
    }
    $path =~ s,([?\#]), URI::Escape::escape_char($1),eg;
    $uri .= $path;
    if (defined $query) {
	$query =~ s,(\#), URI::Escape::escape_char($1),eg;
	$uri .= "?$query";
    }
    $uri .= "#$frag" if defined $frag;
    $uri;
}

__END__

=head1 NAME

URI::Split - Parse and compose URI strings

=head1 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);

=head1 DESCRIPTION

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

=over

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

Breaks up a URI string into its component
parts.  An C<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 C<undef>.

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

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

Puts together a URI string from its parts.
Missing parts are signaled by passing C<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.

=back

=head1 SEE ALSO

L<URI>, L<URI::Escape>

=head1 COPYRIGHT

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

=cut

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📁 file/	DIR	—	2026-03-10 17:26
📁 urn/	DIR	—	2026-03-10 17:26
📄 _foreign.pm	PM	107 B	2024-02-09 15:01	EDIT
📄 _generic.pm	PM	6.7 KB	2024-02-09 15:01	EDIT
📄 _idna.pm	PM	2 KB	2024-02-09 15:01	EDIT
📄 _ldap.pm	PM	3.2 KB	2024-02-09 15:01	EDIT
📄 _login.pm	PM	231 B	2024-02-09 15:01	EDIT
📄 _punycode.pm	PM	5.5 KB	2024-02-09 15:01	EDIT
📄 _query.pm	PM	4.5 KB	2024-02-09 15:01	EDIT
📄 _segment.pm	PM	416 B	2024-02-09 15:01	EDIT
📄 _server.pm	PM	3.8 KB	2024-02-09 15:01	EDIT
📄 _userpass.pm	PM	1 KB	2024-02-09 15:01	EDIT
📄 data.pm	PM	3.3 KB	2024-02-09 15:01	EDIT
📄 Escape.pm	PM	7.7 KB	2024-02-09 15:01	EDIT
📄 file.pm	PM	9.5 KB	2024-02-09 15:01	EDIT
📄 ftp.pm	PM	1 KB	2024-02-09 15:01	EDIT
📄 geo.pm	PM	10.5 KB	2024-02-09 15:01	EDIT
📄 gopher.pm	PM	2.4 KB	2024-02-09 15:01	EDIT
📄 Heuristic.pm	PM	6.4 KB	2024-02-09 15:01	EDIT
📄 http.pm	PM	425 B	2024-02-09 15:01	EDIT
📄 https.pm	PM	144 B	2024-02-09 15:01	EDIT
📄 icap.pm	PM	1.5 KB	2024-02-09 15:01	EDIT
📄 icaps.pm	PM	1.4 KB	2024-02-09 15:01	EDIT
📄 IRI.pm	PM	794 B	2024-02-09 15:01	EDIT
📄 ldap.pm	PM	2.9 KB	2024-02-09 15:01	EDIT
📄 ldapi.pm	PM	440 B	2024-02-09 15:01	EDIT
📄 ldaps.pm	PM	144 B	2024-02-09 15:01	EDIT
📄 mailto.pm	PM	1.6 KB	2024-02-09 15:01	EDIT
📄 mms.pm	PM	125 B	2024-02-09 15:01	EDIT
📄 news.pm	PM	1.4 KB	2024-02-09 15:01	EDIT
📄 nntp.pm	PM	127 B	2024-02-09 15:01	EDIT
📄 nntps.pm	PM	144 B	2024-02-09 15:01	EDIT
📄 pop.pm	PM	1.2 KB	2024-02-09 15:01	EDIT
📄 QueryParam.pm	PM	655 B	2024-02-09 15:01	EDIT
📄 rlogin.pm	PM	129 B	2024-02-09 15:01	EDIT
📄 rsync.pm	PM	207 B	2024-02-09 15:01	EDIT
📄 rtsp.pm	PM	125 B	2024-02-09 15:01	EDIT
📄 rtspu.pm	PM	126 B	2024-02-09 15:01	EDIT
📄 sftp.pm	PM	98 B	2024-02-09 15:01	EDIT
📄 sip.pm	PM	1.6 KB	2024-02-09 15:01	EDIT
📄 sips.pm	PM	143 B	2024-02-09 15:01	EDIT
📄 snews.pm	PM	172 B	2024-02-09 15:01	EDIT
📄 Split.pm	PM	2.3 KB	2024-02-09 15:01	EDIT
📄 ssh.pm	PM	175 B	2024-02-09 15:01	EDIT
📄 telnet.pm	PM	128 B	2024-02-09 15:01	EDIT
📄 tn3270.pm	PM	128 B	2024-02-09 15:01	EDIT
📄 URL.pm	PM	5.4 KB	2024-02-09 15:01	EDIT
📄 urn.pm	PM	2 KB	2024-02-09 15:01	EDIT
📄 WithBase.pm	PM	3.8 KB	2024-02-09 15:01	EDIT