YStudio Y++

网址类

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

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

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

硬约束

  1. 类型名必须写「网址类」。
  2. 解析/改写 URL 各部分(协议、主机、路径、查询、片段)。
  3. 查询串整体编辑见 查询串类。

快速开始

网址类 u
如果 (u.解析("https://a.com/x?y=1#z")) {
    输出(u.取主机())
    输出(u.取路径())
    输出(u.到文本())
}

网址类/创建

共 1 条。

创建网址

  • 签名:通用 创建网址()
  • 说明:创建一个网址对象。一般直接写「网址类 u」即可(声明时自动创建)。

网址类/方法

共 21 条。

解析

  • 签名:逻辑 解析(文本 网址)
  • 说明:解析网址文本;成功返回真。
  • 参数一│文本 网址: 完整或相对网址。

到文本

  • 签名:文本 到文本()
  • 说明:把当前网址重新拼成文本。

取协议

  • 签名:文本 取协议()
  • 说明:取协议名(如 https)。

取用户

  • 签名:文本 取用户()
  • 说明:取用户名(如有)。

取密码

  • 签名:文本 取密码()
  • 说明:取密码(如有)。

取主机

  • 签名:文本 取主机()
  • 说明:取主机名或 IP。

取端口

  • 签名:整数 取端口()
  • 说明:取端口;未指定时返回 -1。

取路径

  • 签名:文本 取路径()
  • 说明:取路径部分。

取查询

  • 签名:文本 取查询()
  • 说明:取查询串(不含 ?)。

取片段

  • 签名:文本 取片段()
  • 说明:取片段(不含 #)。

置协议

  • 签名:逻辑 置协议(文本 协议)
  • 说明:设置协议名。
  • 参数一│文本 协议

置用户

  • 签名:逻辑 置用户(文本 用户)
  • 说明:设置用户名。
  • 参数一│文本 用户

置密码

  • 签名:逻辑 置密码(文本 密码)
  • 说明:设置密码。
  • 参数一│文本 密码

置主机

  • 签名:逻辑 置主机(文本 主机)
  • 说明:设置主机。
  • 参数一│文本 主机

置端口

  • 签名:逻辑 置端口(整数 端口)
  • 说明:设置端口;传 -1 表示省略端口。
  • 参数一│整数 端口

置路径

  • 签名:逻辑 置路径(文本 路径)
  • 说明:设置路径。
  • 参数一│文本 路径

置查询

  • 签名:逻辑 置查询(文本 查询)
  • 说明:设置查询串(不要带 ?)。
  • 参数一│文本 查询

置片段

  • 签名:逻辑 置片段(文本 片段)
  • 说明:设置片段(不要带 #)。
  • 参数一│文本 片段

是否有效

  • 签名:逻辑 是否有效()
  • 说明:当前是否已成功解析或拼装。

清空

  • 签名:无 清空()
  • 说明:清空当前网址。

取错误

  • 签名:文本 取错误()
  • 说明:取最近一次失败原因。

易错对照

错误 正确
类型写成「网址」 必须「网址类」
用本类拆 a=1&b=2 查询部分用查询串类

相关

查询串类 · HTTP类 · 编码类