API
#net/urlURL and query encode/decode.
struct URLpub struct URL {
pub scheme string
pub host string
pub path string
pub raw_query string
pub fragment string
pub has_auth bool
}Public struct `URL`.
scheme stringhost stringpath stringraw_query stringfragment stringhas_auth bool(URL) schemepub fn (u URL) scheme() stringCall `scheme` on `URL`.
u URLstring — result string
(URL) hostpub fn (u URL) host() stringMethod on `URL`: host.
u URLstring — result string
(URL) pathpub fn (u URL) path() stringCall `path` on `URL`.
u URLstring — result string
(URL) raw_querypub fn (u URL) raw_query() stringMethod on `URL`: raw query.
u URLstring — result string
(URL) fragmentpub fn (u URL) fragment() stringCall `fragment` on `URL`.
u URLstring — result string
(URL) querypub fn (u URL) query() QueryCall `query` on `URL`. Throws on failure.
u URLQuery — a value of this type
(URL) hostnamepub fn (u URL) hostname() stringCall `hostname` on `URL`.
u URLstring — result string
(URL) portpub fn (u URL) port() stringMethod on `URL`: port.
u URLstring — result string
(URL) request_uripub fn (u URL) request_uri() stringMethod on `URL`: request uri.
u URLstring — result string
(URL) join_pathpub fn (u URL) join_path(elem <-> string) URLMethod on `URL`: join path.
u URLelem <-> stringURL — a value of this type
new_urlpub fn new_url() URLnew_url returns an empty URL for in-place parse.
none
URL — a value of this type
parse_urlpub fn parse_url(s string) URLParse as url.
s stringURL — a value of this type
(&mut URL) parsepub fn (u &mut URL) parse(s string) intparse fills u from a raw URL (RFC 3986 appendix B shape scheme://host/path?query#fragment). On error the URL keeps its previous components — never a partial parse result. Throws on failure.
u &mut URLs stringint — a value of this type
(URL) to_stringpub fn (u URL) to_string() stringto_string re-emits the URL from its stored components ( URL.String).
u URLstring — result string
struct Querypub struct Query {
pub pairs []string
}Public struct `Query`.
pairs []stringnew_querypub fn new_query() QueryConstruct query.
none
Query — a value of this type
(Query) lenpub fn (q Query) len() intMethod on `Query`: return the length.
q Queryint — a value of this type
(Query) atpub fn (q Query) at(i int) stringCall `at` on `Query`.
q Queryi intstring — result string
(&mut Query) parsepub fn (q &mut Query) parse(query string) intparse decodes a query string into "key=value" pairs ('+' is a space, %XX are unescaped; '=' always present). Bad escapes throw — never a partial result. Caller-owned Query: pairs live in q. Throws on failure.
q &mut Queryquery stringint — a value of this type
query_unescapepub fn query_unescape(s &string) stringquery_escape percent-encodes for a query component: unreserved (a-Za-z0-9-._~) kept, space becomes '+', everything else %XX. Throws on failure.
s &stringstring — result string
path_unescapepub fn path_unescape(s &string) stringPath unescape. Throws on failure.
s &stringstring — result string
(Query) getpub fn (q Query) get(key string) stringCall `get` on `Query`.
q Querykey stringstring — result string
(&mut Query) setpub fn (q &mut Query) set(key string, val string)Call `set` on `&mut Query`.
q &mut Querykey stringval string(&mut Query) addpub fn (q &mut Query) add(key string, val string)Method on `&mut Query`: add.
q &mut Querykey stringval string(&mut Query) delpub fn (q &mut Query) del(key string)Call `del` on `&mut Query`.
q &mut Querykey string(Query) haspub fn (q Query) has(key string) boolCall `has` on `Query`.
q Querykey stringbool — true or false
(Query) encodepub fn (q Query) encode() stringMethod on `Query`: encode.
q Querystring — result string
query_escapepub fn query_escape(s &string) stringQuery escape.
s &stringstring — result string
path_escapepub fn path_escape(s &string) stringpath_escape percent-encodes for a path segment: unreserved plus $&+,/:;=@ kept, everything else %XX (space becomes %20).
s &stringstring — result string
(&URL) resolve_referencepub fn (base &URL) resolve_reference(ref string) URLresolve_reference is URL.ResolveReference for this RFC 3986 subset (scheme/host/path/query/fragment; no userinfo). Throws on failure.
base &URLref stringURL — a value of this type