Skip to content

Parse a URL into its component pieces

Source: R/url.R
url_parse.Rd

url_parse() parses a URL into its component parts, powered by curl::curl_parse_url(). The parsing algorithm follows the specifications detailed in RFC 3986.

Usage

url_parse(url, base_url = NULL)

Arguments

url

A string containing the URL to parse.

base_url

Use this as a parent, if url is a relative URL.

Value

An S3 object of class httr2_url with the following components: scheme, hostname, username, password, port, path, query, and fragment.

See also

Other URL manipulation: url_build(), url_modify()

Examples

url_parse("http://google.com/")
#> <httr2_url> http://google.com/
#> • scheme: http
#> • hostname: google.com
#> • path: /
url_parse("http://google.com:80/")
#> <httr2_url> http://google.com:80/
#> • scheme: http
#> • hostname: google.com
#> • port: 80
#> • path: /
url_parse("http://google.com:80/?a=1&b=2")
#> <httr2_url> http://google.com:80/?a=1&b=2
#> • scheme: http
#> • hostname: google.com
#> • port: 80
#> • path: /
#> • query:
#>   • a: 1
#>   • b: 2
url_parse("http://username@google.com:80/path;test?a=1&b=2#40")
#> <httr2_url> http://username@google.com:80/path;test?a=1&b=2#40
#> • scheme: http
#> • hostname: google.com
#> • username: username
#> • port: 80
#> • path: /path;test
#> • query:
#>   • a: 1
#>   • b: 2
#> • fragment: 40

# You can parse a relative URL if you also provide a base url
url_parse("foo", "http://google.com/bar/")
#> <httr2_url> http://google.com/bar/foo
#> • scheme: http
#> • hostname: google.com
#> • path: /bar/foo
url_parse("..", "http://google.com/bar/")
#> <httr2_url> http://google.com/
#> • scheme: http
#> • hostname: google.com
#> • path: /