---
name: "URI::Split"
section: "3pm"
platform: "linux"
package: "perl-uri"
version: "5.40-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/URI::Split"
---

# URI::Split(3pm)

Parse and compose URI strings

## 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.