类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → 网址类。
类型名必须写完整「网址类」。声明时自动创建,一般无需再调 创建*。
硬约束
- 类型名必须写「网址类」。
- 解析/改写 URL 各部分(协议、主机、路径、查询、片段)。
- 查询串整体编辑见 查询串类。
快速开始
网址类 u
如果 (u.解析("https://a.com/x?y=1#z")) {
输出(u.取主机())
输出(u.取路径())
输出(u.到文本())
}
网址类/创建
共 1 条。
创建网址
- 签名:
通用 创建网址() - 说明:创建一个网址对象。一般直接写「网址类 u」即可(声明时自动创建)。
网址类/方法
共 21 条。
解析
- 签名:
逻辑 解析(文本 网址) - 说明:解析网址文本;成功返回真。
- 参数一│文本 网址: 完整或相对网址。
到文本
- 签名:
文本 到文本() - 说明:把当前网址重新拼成文本。
取协议
- 签名:
文本 取协议() - 说明:取协议名(如 https)。
取用户
- 签名:
文本 取用户() - 说明:取用户名(如有)。
取密码
- 签名:
文本 取密码() - 说明:取密码(如有)。
取主机
- 签名:
文本 取主机() - 说明:取主机名或 IP。
取端口
- 签名:
整数 取端口() - 说明:取端口;未指定时返回 -1。
取路径
- 签名:
文本 取路径() - 说明:取路径部分。
取查询
- 签名:
文本 取查询() - 说明:取查询串(不含 ?)。
取片段
- 签名:
文本 取片段() - 说明:取片段(不含 #)。
置协议
- 签名:
逻辑 置协议(文本 协议) - 说明:设置协议名。
- 参数一│文本 协议
置用户
- 签名:
逻辑 置用户(文本 用户) - 说明:设置用户名。
- 参数一│文本 用户
置密码
- 签名:
逻辑 置密码(文本 密码) - 说明:设置密码。
- 参数一│文本 密码
置主机
- 签名:
逻辑 置主机(文本 主机) - 说明:设置主机。
- 参数一│文本 主机
置端口
- 签名:
逻辑 置端口(整数 端口) - 说明:设置端口;传 -1 表示省略端口。
- 参数一│整数 端口
置路径
- 签名:
逻辑 置路径(文本 路径) - 说明:设置路径。
- 参数一│文本 路径
置查询
- 签名:
逻辑 置查询(文本 查询) - 说明:设置查询串(不要带 ?)。
- 参数一│文本 查询
置片段
- 签名:
逻辑 置片段(文本 片段) - 说明:设置片段(不要带 #)。
- 参数一│文本 片段
是否有效
- 签名:
逻辑 是否有效() - 说明:当前是否已成功解析或拼装。
清空
- 签名:
无 清空() - 说明:清空当前网址。
取错误
- 签名:
文本 取错误() - 说明:取最近一次失败原因。
易错对照
| 错误 | 正确 |
|---|---|
| 类型写成「网址」 | 必须「网址类」 |
| 用本类拆 a=1&b=2 | 查询部分用查询串类 |