豫豫言文档API ATLAS
入口包说明.html
2 模块13 名称
← 全部模块

模块 / 2

规整。豫

规整。豫

9公开名称

文字上限字节

公开
「整数」

文言:输入至多一 MiB(UTF-8 字节)。汉语:单次输入的 UTF-8 字节上限,超出则抛出豫言异常,避免一次交换过大。

验文字大小

公开
化「字符串」而「有」

暂无说明。

造字符串对象

公开
化「字符串」而「字符串」

文言:以原字节入宿主,由 TextDecoder 还为 JS 字符串(ignoreBOM 使文首之 U+FEFF 不失),再造 String 对象,返其句柄号。全程不经豫言之 JSON 转义,故任何字符皆无损。汉语:先把字符串的 UTF-8 字节交给宿主,用 TextDecoder(ignoreBOM: true)还原成 JS 字符串;再用宿主返回的 JSON 字面量构造 String 对象并返回句柄号。整个过程不经过豫言的 JSON 编码器,所以控制字符、引号、U+2028 等都不会出错。

字面还原为文

公开
化「字符串」而「字符串」

文言:宿主所返之 JSON 字面量,仍交宿主 TextEncoder 编为 UTF-8,再按原字节取回;豫言不解析 JSON 转义。汉语:把宿主返回的 JSON 字符串字面量再交给 TextEncoder 编码为 UTF-8 字节并取回,用 TextDecoder(ignoreBOM: true)还原为豫言字符串;豫言一侧完全不解析 JSON 转义,因此 \u 转义、孤立代理项之外的一切字符都精确往返。

宿主字符串方法

公开
化「字符串」而化「字符串」而「字符串」

文言:调 String 对象之无参方法,返文;用毕释诸句柄,使单次事件内可屡屡调用而不竭句柄。汉语:在 String 对象上调用无参方法并取回结果字符串,用完释放句柄,避免单次事件里多次调用耗尽句柄表。

去首尾空白

公开
化「字符串」而「字符串」

文言:授 String.prototype.trim,其空白之界即 ECMAScript 之 WhiteSpace 与 LineTerminator。汉语:交给 String.prototype.trim,空白的范围就是 ECMAScript 的 WhiteSpace 与 LineTerminator。

转小写

公开
化「字符串」而「字符串」

文言:授 String.prototype.toLowerCase,用完整之 Unicode 映射与词尾之规。汉语:交给 String.prototype.toLowerCase,使用完整 Unicode 映射和上下文规则。

UTF16长度

公开
化「字符串」而「整数」

文言:读 String 对象之 length 属性,即 UTF-16 码元之数。汉语:读取 String 对象的 length 属性,即 UTF-16 码元数;增补平面字符计为 2。

全为字母或数字吗

公开
化「字符串」而「爻」

文言:以 RegExp 之 \p{L}\p{N} 判文,文非空而诸字皆字母或数字则阳;用毕释诸句柄。 汉语:在宿主构造 RegExp 对象 /^[\p{L}\p{N}]+$/u 并对 String 对象调用 test,语义与 JS 完全一致(Unicode 版本由宿主引擎决定);用完释放 String 与 RegExp 句柄。