类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → 查询串类。
类型名必须写完整「查询串类」。声明时自动创建,一般无需再调 创建*。
硬约束
- 类型名必须写「查询串类」。
- 处理 URL
?后a=1&b=2;完整 URL 请先用网址类。 - 单值 Url 编码用编码类 / 编码支持库。
快速开始
查询串类 q
如果 (q.解析("a=1&b=hello")) {
q.置值("c", "中文")
输出(q.到文本(真))
}
查询串类/创建
共 1 条。
创建查询串
- 签名:
通用 创建查询串() - 说明:创建 URL 查询参数(? 后 a=1&b=2)容器。通常直接写「查询串类 q」。
查询串类/方法
共 10 条。
解析
- 签名:
逻辑 解析(文本 查询串) - 说明:解析 a=1&b=2 并写入对象;可带或不带前导 ?;%XX 与 + 自动解码。
- 参数一│文本 查询串: 仅 ? 后部分,不要传完整 URL。
到文本
- 签名:
文本 到文本([逻辑 编码=假]) - 说明:拼成 a=1&b=2 文本。编码=真 时对键和值做 URL 编码(提交 HTTP 时用)。
- 参数一│[逻辑 编码=假]: 真=百分号编码后再拼接。
取值
- 签名:
文本 取值(文本 键) - 说明:按键取值;不存在时返回空文本。
- 参数一│文本 键
置值
- 签名:
逻辑 置值(文本 键, 文本 值) - 说明:设置或覆盖键值;键已存在则覆盖,不存在则追加。
- 参数一│文本 键
- 参数二│文本 值: 无需预先编码。
移除
- 签名:
逻辑 移除(文本 键) - 说明:移除指定键;不存在返回假。
- 参数一│文本 键
是否有
- 签名:
逻辑 是否有(文本 键) - 说明:是否包含指定键。
- 参数一│文本 键
取数量
- 签名:
整数 取数量() - 说明:取键值对数量。
取键
- 签名:
文本 取键(整数 索引) - 说明:按索引取键名;索引从 0 开始。
- 参数一│整数 索引
清空
- 签名:
无 清空() - 说明:清空所有键值。
取错误
- 签名:
文本 取错误() - 说明:取最近一次失败原因。
易错对照
| 错误 | 正确 |
|---|---|
| 类型写成「查询串」 | 必须「查询串类」 |
| 把完整 URL 当查询串 | 先网址类.解析,再取查询 |