YStudio Y++

查询串类

Y++ / YStudio 开发文档 · 一点滴

类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → 查询串类。

类型名必须写完整「查询串类」。声明时自动创建,一般无需再调 创建*。

硬约束

  1. 类型名必须写「查询串类」。
  2. 处理 URL ? 后 a=1&b=2;完整 URL 请先用网址类。
  3. 单值 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 当查询串 先网址类.解析,再取查询

相关

网址类 · HTTP类 · 编码类