YStudio Y++

编码支持库

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

路径:支持库 → 编码支持库。

硬约束

  1. 扁平命令:到Base64("x"),无对象前缀。
  2. 正规 GBK ↔ UTF-8 换码请用字节集 API;文本版 编码转换 是乱码修复语义。
  3. 文本摘要用本库 取MD5 等;字节集摘要用 加密解密 的 MD5字节集。
  4. 多实例各自默认字符集时用 编码类;一般脚本用本库即可。

快速开始

输出(到Base64("你好"))
输出(取MD5("abc"))
字节集 gbk = 文本到编码字节集("你好", "gbk")
输出(编码字节集到文本(gbk, "gbk"))
字节集 u8 = 编码转换字节集(gbk, "gbk", "utf-8")

字符集

本分类共 10 条。

取编码错误

  • 签名:文本 取编码错误()
  • 说明:取最近一次扁平编码命令的错误信息(成功时为空)。

取默认字符集

  • 签名:文本 取默认字符集()
  • 说明:取当前默认字符集名。

文本到编码字节集

  • 签名:字节集 文本到编码字节集(文本 内容, [文本 编码名=""])
  • 说明:将 Unicode 文本按指定字符集编码为字节集。编码名空=默认字符集。
  • 参数一│文本 内容
  • 参数二│[文本 编码名=”“]: utf-8 / gbk / big5 等

编码从Utf8

  • 签名:文本 编码从Utf8(文本 内容, [文本 目标编码=""])
  • 说明:乱码修复:按 UTF-8 收字节再按目标编码解。目标 utf-8 时原样返回。
  • 参数一│文本 内容
  • 参数二│[文本 目标编码=”“]: 空=默认字符集

编码到Utf8

  • 签名:文本 编码到Utf8(文本 内容, [文本 来源编码=""])
  • 说明:乱码修复:按来源编码收字节再按 UTF-8 解。来源 utf-8 时原样返回。正规换编码用 文本到编码字节集/编码转换字节集。
  • 参数一│文本 内容
  • 参数二│[文本 来源编码=”“]: 空=默认字符集

编码名是否有效

  • 签名:逻辑 编码名是否有效(文本 编码名)
  • 说明:是否为内置编码名(utf-8/gbk/big5/ascii/latin1 等)。
  • 参数一│文本 编码名

编码字节集到文本

  • 签名:文本 编码字节集到文本(字节集 数据, [文本 编码名=""])
  • 说明:将字节集按指定字符集解码为 Unicode 文本。
  • 参数一│字节集 数据
  • 参数二│[文本 编码名=”“]

编码转换

  • 签名:文本 编码转换(文本 内容, 文本 来源编码, 文本 目标编码)
  • 说明:乱码修复:按来源收字节再按目标解开;同编码原样返回。正规 GBK↔UTF-8 用 编码转换字节集。
  • 参数一│文本 内容
  • 参数二│文本 来源编码: 如 “gbk”、”utf-8”
  • 参数三│文本 目标编码: 如 “utf-8”、”gbk”

编码转换字节集

  • 签名:字节集 编码转换字节集(字节集 数据, 文本 来源编码, 文本 目标编码)
  • 说明:字节集换编码:按来源解码再按目标编码(真实 GBK↔UTF-8)。
  • 参数一│字节集 数据
  • 参数二│文本 来源编码
  • 参数三│文本 目标编码

置默认字符集

  • 签名:逻辑 置默认字符集(文本 编码名)
  • 说明:设置扁平编码命令的默认字符集(默认 GBK)。成功返回真。
  • 参数一│文本 编码名: utf-8 / gbk / big5 等

文本编解码

本分类共 10 条。

从Base64

  • 签名:文本 从Base64(文本 Base64串)
  • 说明:Base64 解码为文本。等价于 Base64解码。
  • 参数一│文本 Base64串

从Base64到字节集

  • 签名:字节集 从Base64到字节集(文本 Base64串)
  • 说明:Base64 解码为字节集。等价于 Base64解码到字节集。
  • 参数一│文本 Base64串

从HTML编码

  • 签名:文本 从HTML编码(文本 内容)
  • 说明:HTML 实体解码。等价于 HTML解码。
  • 参数一│文本 内容

从URL编码

  • 签名:文本 从URL编码(文本 内容)
  • 说明:URL 百分号解码。等价于 URL解码。
  • 参数一│文本 内容

从十六进制文本

  • 签名:文本 从十六进制文本(文本 十六进制)
  • 说明:十六进制还原为文本。等价于 十六进制解码。
  • 参数一│文本 十六进制

到Base64

  • 签名:文本 到Base64(文本 内容)
  • 说明:文本按 UTF-8 转字节后再 Base64 编码。等价于 Base64编码。
  • 参数一│文本 内容

到Base64字节集

  • 签名:文本 到Base64字节集(字节集 数据)
  • 说明:字节集 Base64 编码。等价于 Base64编码字节集。
  • 参数一│字节集 数据

到HTML编码

  • 签名:文本 到HTML编码(文本 内容)
  • 说明:HTML 实体编码。等价于 HTML编码。
  • 参数一│文本 内容

到URL编码

  • 签名:文本 到URL编码(文本 内容)
  • 说明:URL 百分号编码。等价于 URL编码。
  • 参数一│文本 内容

到十六进制文本

  • 签名:文本 到十六进制文本(文本 内容)
  • 说明:文本转十六进制表示。等价于 十六进制编码。
  • 参数一│文本 内容

摘要

本分类共 4 条。

取MD5

  • 签名:文本 取MD5(文本 内容)
  • 说明:计算文本 MD5(小写十六进制)。等价于 MD5。
  • 参数一│文本 内容

取SHA1

  • 签名:文本 取SHA1(文本 内容)
  • 说明:计算 SHA1。等价于 SHA1。
  • 参数一│文本 内容

取SHA256

  • 签名:文本 取SHA256(文本 内容)
  • 说明:计算 SHA256。等价于 SHA256。
  • 参数一│文本 内容

取SHA512

  • 签名:文本 取SHA512(文本 内容)
  • 说明:计算 SHA512。等价于 SHA512。
  • 参数一│文本 内容

兼容旧名

本分类共 14 条。

Base64编码

  • 签名:文本 Base64编码(文本 内容)
  • 说明:【兼容】等价于 到Base64。推荐使用新名。
  • 参数一│文本 内容

Base64编码字节集

  • 签名:文本 Base64编码字节集(字节集 数据)
  • 说明:【兼容】等价于 到Base64字节集。
  • 参数一│字节集 数据

Base64解码

  • 签名:文本 Base64解码(文本 Base64文本)
  • 说明:【兼容】等价于 从Base64。
  • 参数一│文本 Base64文本

Base64解码到字节集

  • 签名:字节集 Base64解码到字节集(文本 内容)
  • 说明:【兼容】等价于 从Base64到字节集。
  • 参数一│文本 内容

HTML编码

  • 签名:文本 HTML编码(文本 内容)
  • 说明:【兼容】等价于 到HTML编码。
  • 参数一│文本 内容

HTML解码

  • 签名:文本 HTML解码(文本 内容)
  • 说明:【兼容】等价于 从HTML编码。
  • 参数一│文本 内容

MD5

  • 签名:文本 MD5(文本 内容)
  • 说明:【兼容】等价于 取MD5。
  • 参数一│文本 内容

SHA1

  • 签名:文本 SHA1(文本 内容)
  • 说明:【兼容】等价于 取SHA1。
  • 参数一│文本 内容

SHA256

  • 签名:文本 SHA256(文本 内容)
  • 说明:【兼容】等价于 取SHA256。
  • 参数一│文本 内容

SHA512

  • 签名:文本 SHA512(文本 内容)
  • 说明:【兼容】等价于 取SHA512。
  • 参数一│文本 内容

URL编码

  • 签名:文本 URL编码(文本 内容)
  • 说明:【兼容】等价于 到URL编码。
  • 参数一│文本 内容

URL解码

  • 签名:文本 URL解码(文本 内容)
  • 说明:【兼容】等价于 从URL编码。
  • 参数一│文本 内容

十六进制编码

  • 签名:文本 十六进制编码(文本 内容)
  • 说明:【兼容】等价于 到十六进制文本。
  • 参数一│文本 内容

十六进制解码

  • 签名:文本 十六进制解码(文本 十六进制)
  • 说明:【兼容】等价于 从十六进制文本。
  • 参数一│文本 十六进制

与加密解密如何划分

能力 文档
Base64 / URL / HTML / 十六进制 / MD5 / SHA(文本) 本页
字符集(字节集换码 + 乱码修复) 本页
AES / RC4 / XOR / UUID / 随机密钥 / Unicode 转义 / MD5字节集 crypto-support.md

旧名(Base64编码、MD5、URL编码 等)仍可编译;面板与文档以「到/从」「取*」为准。

系统编码常量(整数)

常量 值
#编码_自动 0
#编码_UNICODE 1200
#编码_GBK 936
#编码_UTF8 65001

编码名字符串常用:utf-8、gbk、big5 等。

注意:文本版 编码转换 / 编码到Utf8 / 编码从Utf8 是乱码修复语义,不是「把 Unicode 重新编码成另一种 charset 字符串」。正规 GBK↔UTF-8 请用字节集 API。


易错对照

错误 正确
用文本 编码转换 当真换码 用 编码转换字节集 / 文本到编码字节集
与加密解密混淆 AES 等见加密解密;本页是编解码/摘要
需要多默认字符集实例 用编码类

相关

加密解密 · 编码类 · 字节集