url
21 items · generated by scribe fromstdlib/url.fd· synced 2026-11-15
Contents
- Url (struct)
- url_encode (function)
- url_encode_path (function)
- url_encode_form (function)
- url_decode (function)
- url_decode_form (function)
- url_parse (function)
- url_to_str (function)
- url_query_get (function)
- url_query_has (function)
- url_query_keys (function)
- url_query_build (function)
- url_resolve (function)
- url_normalize_path (function)
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:
| Name | Type |
|---|---|
scheme | str |
userinfo | str |
host | str |
port | i64 |
path | str |
query | str |
fragment | str |
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:strkey: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:strkey: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
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:Urlrel: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