Skip to content

stdlib/urlView source ↗

url

21 items · generated by scribe fromstdlib/url.fd· synced 2026-11-15

stdlib/url21 items

Contents

Url

A parsed absolute or relative URL. Missing parts are "" (port is -1 when not present; userinfo holds “user” or “user:pass”).

pub struct Url {

Fields:

NameType
schemestr
userinfostr
hoststr
porti64
pathstr
querystr
fragmentstr

Defined at line 18


url_encode

Percent-encode s — only unreserved bytes pass through.

Example: assert_eq(url_encode(“a b/c”), “a%20b%2Fc”);

pub fn url_encode(s: str) -> str {

Parameters:

  • s: str

Returns: str

Defined at line 57


url_encode_path

Percent-encode a path, keeping ”/” and the other characters a path may hold.

Example: assert_eq(url_encode_path(“/docs/my file.txt”), “/docs/my%20file.txt”);

pub fn url_encode_path(s: str) -> str {

Parameters:

  • s: str

Returns: str

Defined at line 95


url_encode_form

Encode for query/form values — like url_encode but space → ’+’.

Example: assert_eq(url_encode_form(“a b&c”), “a+b%26c”);

pub fn url_encode_form(s: str) -> str {

Parameters:

  • s: str

Returns: str

Defined at line 111


url_decode

Percent-decode s; ’+’ stays literal (use url_decode_form for query). Invalid % sequences are passed through unchanged.

Example: assert_eq(url_decode(“a%20b%2Fc”), “a b/c”);

pub fn url_decode(s: str) -> str {

Parameters:

  • s: str

Returns: str

Defined at line 134


url_decode_form

Percent-decode with ’+’ → ’ ’ (application/x-www-form-urlencoded).

Example: assert_eq(url_decode_form(“a+b%26c”), “a b&c”);

pub fn url_decode_form(s: str) -> str {

Parameters:

  • s: str

Returns: str

Defined at line 178


url_parse

Parse a URL string into a Url struct. Lenient: missing components are left empty; port is -1 when absent or unparseable.

Example: var u = url_parse(“https://user@example.com:8443/a/b?x=1&y=2#top”); assert_eq(u.scheme, “https”); assert_eq(u.userinfo, “user”); assert_eq(u.host, “example.com”); assert_eq(u.port, 8443); assert_eq(u.path, “/a/b”); assert_eq(u.query, “x=1&y=2”); assert_eq(u.fragment, “top”); assert_eq(url_parse(“http://example.com”).port, -1);

pub fn url_parse(s: str) -> Url {

Parameters:

  • s: str

Returns: Url

Defined at line 197


url_to_str

Serialize a Url struct back to a string (components re-encoded).

Example: var u = url_parse(“http://example.com/x?q=1”); u.path = “/y”; assert_eq(url_to_str(u), “http://example.com/y?q=1”);

pub fn url_to_str(u: Url) -> str {

Parameters:

  • u: Url

Returns: str

Defined at line 302


url_query_get

Value of key in a query string (“a=1&b=2”); "" when absent.

Example: assert_eq(url_query_get(“name=Ada%20L&age=36”, “name”), “Ada L”); assert_eq(url_query_get(“a=1”, “b”), "");

pub fn url_query_get(query: str, key: str) -> str {

Parameters:

  • query: str
  • key: str

Returns: str

Defined at line 338


url_query_has

True if key appears in the query string.

Example: assert(url_query_has(“debug&x=1”, “debug”)); assert(!url_query_has(“x=1”, “y”));

pub fn url_query_has(query: str, key: str) -> bool {

Parameters:

  • query: str
  • key: str

Returns: bool

Defined at line 363


url_query_keys

All keys of the query string in order (decoded).

Example: var k = url_query_keys(“a=1&b=2&c”); assert_eq(k.len(), 3); assert_eq(k.get(2), “c”);

pub fn url_query_keys(query: str) -> Vec<str> {

Parameters:

  • query: str

Returns: Vec<str>

Defined at line 387


url_query_build

Build a query string from parallel key/value vecs (form-encoded).

Example: var k: Vec= Vec::new(); var v: Vec= Vec::new(); k.push(“q”); v.push(“fides lang”); k.push(“page”); v.push(“2”); assert_eq(url_query_build(k, v), “q=fides+lang&page=2”);

pub fn url_query_build(keys: Vec<str>, values: Vec<str>) -> str {

Parameters:

  • keys: Vec<str>
  • values: Vec<str>

Returns: str

Defined at line 416


url_resolve

Resolve rel against base (RFC 3986 §5.2, no scheme changes). Handles absolute paths, relative paths, and dot segments.

Example: var base = url_parse(“http://a.com/b/c/d”); assert_eq(url_resolve(base, ”../e”), “http://a.com/b/e”); assert_eq(url_resolve(base, “/x”), “http://a.com/x”);

pub fn url_resolve(base: Url, rel: str) -> str {

Parameters:

  • base: Url
  • rel: str

Returns: str

Defined at line 441


url_normalize_path

Collapse ”.” and ”..” segments in a path.

Example: assert_eq(url_normalize_path(“/a/./b/../c”), “/a/c”);

pub fn url_normalize_path(p: str) -> str {

Parameters:

  • p: str

Returns: str

Defined at line 502


Generated by scribe, the Fides documentation generator