API

`#net/url`

import: #net/url

counts: 7 函数, 22 方法, 2 类型, 0 常量, 0 方法集

URL 与 query 编解码。

`struct URL`

XuAPI

pub struct URL {
    pub scheme string
    pub host string
    pub path string
    pub raw_query string
    pub fragment string
    pub has_auth bool
}

用途

公开结构体 `URL`。

参数

scheme string: 字段（string）
host string: 主机
path string: 文件系统路径
raw_query string: 字段（string）
fragment string: 字段（string）
has_auth bool: 字段（bool）

`(URL) scheme`

XuAPI

pub fn (u URL) scheme() string

用途

在 `URL` 上调用 `scheme`。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`(URL) host`

XuAPI

pub fn (u URL) host() string

用途

`URL` 上的方法：主机。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`(URL) path`

XuAPI

pub fn (u URL) path() string

用途

在 `URL` 上调用 `path`。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`(URL) raw_query`

XuAPI

pub fn (u URL) raw_query() string

用途

`URL` 上的方法：raw查询串。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`(URL) fragment`

XuAPI

pub fn (u URL) fragment() string

用途

在 `URL` 上调用 `fragment`。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`(URL) query`

XuAPI

pub fn (u URL) query() Query

用途

`URL` 上的方法：查询串。失败时 throw。

参数

u URL: 接收者 URL（值接收者）

Query — 该类型的值

`(URL) hostname`

XuAPI

pub fn (u URL) hostname() string

用途

`URL` 上的方法：主机名。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`(URL) port`

XuAPI

pub fn (u URL) port() string

用途

`URL` 上的方法：端口。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`(URL) request_uri`

XuAPI

pub fn (u URL) request_uri() string

用途

`URL` 上的方法：请求uri。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`(URL) join_path`

XuAPI

pub fn (u URL) join_path(elem <-> string) URL

用途

`URL` 上的方法：拼接path。

参数

u URL: 接收者 URL（值接收者）
elem <-> string: 可变参数，类型 string，在函数体内是 []string

URL — 该类型的值

`new_url`

XuAPI

pub fn new_url() URL

用途

构造 url。

参数

无

URL — 该类型的值

`parse_url`

XuAPI

pub fn parse_url(s string) URL

用途

解析为 url。

参数

s string: 源字符串（string）

URL — 该类型的值

`(&mut URL) parse`

XuAPI

pub fn (u &mut URL) parse(s string) int

用途

`&mut URL` 上的方法：解析输入。失败时 throw。

参数

u &mut URL: 接收者 &mut URL（可变借用）
s string: 源字符串（string）

int — 该类型的值

`(URL) to_string`

XuAPI

pub fn (u URL) to_string() string

用途

`URL` 上的方法：转成 string。

参数

u URL: 接收者 URL（值接收者）

string — 结果字符串

`struct Query`

XuAPI

pub struct Query {
    pub pairs []string
}

用途

公开结构体 `Query`。

参数

pairs []string: 字段（[]string）

`new_query`

XuAPI

pub fn new_query() Query

用途

构造 query。

参数

无

Query — 该类型的值

`(Query) len`

XuAPI

pub fn (q Query) len() int

用途

`Query` 上的方法：返回长度。

参数

q Query: 接收者 Query（值接收者）

int — 该类型的值

`(Query) at`

XuAPI

pub fn (q Query) at(i int) string

用途

在 `Query` 上调用 `at`。

参数

q Query: 接收者 Query（值接收者）
i int: 下标或整数（int）

string — 结果字符串

`(&mut Query) parse`

XuAPI

pub fn (q &mut Query) parse(query string) int

用途

`&mut Query` 上的方法：解析输入。失败时 throw。

参数

q &mut Query: 接收者 &mut Query（可变借用）
query string: query（string）

int — 该类型的值

`query_unescape`

XuAPI

pub fn query_unescape(s &string) string

用途

查询串反转义。失败时 throw。

参数

s &string: 源字符串（借用，调用方仍持有；类型 &string）

string — 结果字符串

`path_unescape`

XuAPI

pub fn path_unescape(s &string) string

用途

path反转义。失败时 throw。

参数

s &string: 源字符串（借用，调用方仍持有；类型 &string）

string — 结果字符串

`(Query) get`

XuAPI

pub fn (q Query) get(key string) string

用途

在 `Query` 上调用 `get`。

参数

q Query: 接收者 Query（值接收者）
key string: 键（string）

string — 结果字符串

`(&mut Query) set`

XuAPI

pub fn (q &mut Query) set(key string, val string)

用途

在 `&mut Query` 上调用 `set`。

参数

q &mut Query: 接收者 &mut Query（可变借用）
key string: 键（string）
val string: 值（string）

`(&mut Query) add`

XuAPI

pub fn (q &mut Query) add(key string, val string)

用途

`&mut Query` 上的方法：相加。

参数

q &mut Query: 接收者 &mut Query（可变借用）
key string: 键（string）
val string: 值（string）

`(&mut Query) del`

XuAPI

pub fn (q &mut Query) del(key string)

用途

在 `&mut Query` 上调用 `del`。

参数

q &mut Query: 接收者 &mut Query（可变借用）
key string: 键（string）

`(Query) has`

XuAPI

pub fn (q Query) has(key string) bool

用途

`Query` 上的方法：是否具有。

参数

q Query: 接收者 Query（值接收者）
key string: 键（string）

bool — 是否成立

`(Query) encode`

XuAPI

pub fn (q Query) encode() string

用途

`Query` 上的方法：编码。

参数

q Query: 接收者 Query（值接收者）

string — 结果字符串

`query_escape`

XuAPI

pub fn query_escape(s &string) string

用途

查询串转义。

参数

s &string: 源字符串（借用，调用方仍持有；类型 &string）

string — 结果字符串

`path_escape`

XuAPI

pub fn path_escape(s &string) string

用途

path转义。

参数

s &string: 源字符串（借用，调用方仍持有；类型 &string）

string — 结果字符串

`(&URL) resolve_reference`

XuAPI

pub fn (base &URL) resolve_reference(ref string) URL

用途

`&URL` 上的方法：解析reference。失败时 throw。

参数

base &URL: 接收者 &URL（借用）
ref string: ref（string）

URL — 该类型的值