# @ohos.util (util工具函数) 该模块主要提供常用的工具函数，实现字符串编解码（[TextEncoder](#textencoder)，[TextDecoder](#textdecoder)）、有理数运算（[RationalNumber8+](#rationalnumber8)）、缓冲区管理（[LRUCache9+](#lrucache9)）、范围判断（[ScopeHelper9+](#scopehelper9)）、Base64编解码（[Base64Helper9+](#base64helper9)）、内置对象类型检查（[types8+](#types8)）等功能。 > **说明：** > > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 ```js import util from '@ohos.util'; ``` ## util.format9+ format(format: string, ...args: Object[]): string 通过式样化字符串对输入的内容按特定格式输出。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------- | -------- | ---- | -------------- | | format | string | 是 | 式样化字符串。 | | ...args | Object[] | 否 | 替换式样化字符串通配符的数据，此参数缺失时，默认返回第一个参数。 | **返回值：** | 类型 | 说明 | | ------ | ---------------------------- | | string | 按特定格式式样化后的字符串。 | **示例：** ```js let res = util.format("%s", "hello world!"); console.log(res); ``` ## util.errnoToString9+ errnoToString(errno: number): string 获取系统错误码对应的详细信息。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | -------------------------- | | errno | number | 是 | 系统发生错误产生的错误码。 | **返回值：** | 类型 | 说明 | | ------ | ---------------------- | | string | 错误码对应的详细信息。 | **示例：** ```js let errnum = -1; // -1 : a system error number let result = util.errnoToString(errnum); console.log("result = " + result); ``` **部分错误码及信息示例：** | 错误码 | 信息 | | ------ | -------------------------------- | | -1 | operation not permitted | | -2 | no such file or directory | | -3 | no such process | | -4 | interrupted system call | | -5 | i/o error | | -11 | resource temporarily unavailable | | -12 | not enough memory | | -13 | permission denied | | -100 | network is down | ## util.callbackWrapper callbackWrapper(original: Function): (err: Object, value: Object )=>void 对异步函数进行回调化处理，回调中第一个参数将是拒绝原因（如果 Promise 已解决，则为 null），第二个参数将是已解决的值。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | original | Function | 是 | 异步函数。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Function | 返回一个第一个参数是拒绝原因（如果 Promise 已解决，则为 null），第二个参数是已解决的回调函数。 | **示例：** ```js async function fn() { return 'hello world'; } let cb = util.callbackWrapper(fn); cb(1, (err, ret) => { if (err) throw err; console.log(ret); }); ``` ## util.promisify9+ promisify(original: (err: Object, value: Object) => void): Function 对异步函数处理并返回一个promise的函数。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | original | Function | 是 | 异步函数。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Function | 采用遵循常见的错误优先的回调风格的函数（也就是将 (err, value) => ... 回调作为最后一个参数），并返回一个返回 promise 的函数。 | **示例：** ```js function fun(num, callback) { if (typeof num === 'number') { callback(null, num + 3); } else { callback("type err"); } } const addCall = util.promisify(fun); (async () => { try { let res = await addCall(2); console.log(res); } catch (err) { console.log(err); } })(); ``` ## util.generateRandomUUID9+ generateRandomUUID(entropyCache?: boolean): string 使用加密安全随机数生成器生成随机的RFC 4122版本4的string类型UUID。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | entropyCache | boolean | 否 | 是否使用已缓存的UUID， 默认true。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 表示此UUID的字符串。 | **示例：** ```js let uuid = util.generateRandomUUID(true); console.log("RFC 4122 Version 4 UUID:" + uuid); // 输出： // RFC 4122 Version 4 UUID:88368f2a-d5db-47d8-a05f-534fab0a0045 ``` ## util.generateRandomBinaryUUID9+ generateRandomBinaryUUID(entropyCache?: boolean): Uint8Array 使用加密安全随机数生成器生成随机的RFC 4122版本4的Uint8Array类型UUID。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | entropyCache | boolean | 否 | 是否使用已缓存的UUID， 默认true。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Uint8Array | 表示此UUID的Uint8Array值。 | **示例：** ```js let uuid = util.generateRandomBinaryUUID(true); console.log(JSON.stringify(uuid)); // 输出： // 138,188,43,243,62,254,70,119,130,20,235,222,199,164,140,150 ``` ## util.parseUUID9+ parseUUID(uuid: string): Uint8Array 将generateRandomUUID生成的string类型UUID转换为generateRandomBinaryUUID生成的Uint8Array类型UUID，如RFC 4122版本4中所述。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | uuid | string | 是 | UUID字符串。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Uint8Array | 返回表示此UUID的Uint8Array，如果解析失败，则抛出SyntaxError。 | **示例：** ```js let uuid = util.parseUUID("84bdf796-66cc-4655-9b89-d6218d100f9c"); console.log(JSON.stringify(uuid)); // 输出： // 132,189,247,150,102,204,70,85,155,137,214,33,141,16,15,156 ``` ## util.printf(deprecated) printf(format: string, ...args: Object[]): string 通过式样化字符串对输入的内容按特定格式输出。 > **说明：** > > 从API version 7开始支持，从API version 9开始废弃，建议使用[util.format9+](#utilformat9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | format | string | 是 | 式样化字符串。 | | ...args | Object[] | 否 | 替换式样化字符串通配符的数据，此参数缺失时，默认返回第一个参数。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 按特定格式式样化后的字符串。 | **示例：** ```js let res = util.printf("%s", "hello world!"); console.log(res); ``` ## util.getErrorString(deprecated) getErrorString(errno: number): string 获取系统错误码对应的详细信息。 > **说明：** > > 从API version 7开始支持，从API version 9开始废弃，建议使用[util.errnoToString9+](#utilerrnotostring9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | errno | number | 是 | 系统发生错误产生的错误码。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 错误码对应的详细信息。 | **示例：** ```js let errnum = -1; // -1 : a system error number let result = util.getErrorString(errnum); console.log("result = " + result); ``` ## util.promiseWrapper(deprecated) promiseWrapper(original: (err: Object, value: Object) => void): Object 对异步函数处理并返回一个promise的版本。 > **说明：** > > 此接口不可用，建议使用[util.promisify9+](#utilpromisify9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | original | Function | 是 | 异步函数。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Function | 采用遵循常见的错误优先的回调风格的函数（也就是将 (err, value) => ... 回调作为最后一个参数），并返回一个返回 promise 的版本。 | ## TextDecoder TextDecoder用于将字节数组解码为字符串，可以处理多种编码格式，包括utf-8、utf-16le/be、iso-8859和windows-1251等不同的编码格式。 ### 属性 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Utils.Lang。 | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | encoding | string | 是 | 否 | 编码格式。
- 支持格式：utf-8、ibm866、iso-8859-2、iso-8859-3、iso-8859-4、iso-8859-5、iso-8859-6、iso-8859-7、iso-8859-8、iso-8859-8-i、iso-8859-10、iso-8859-13、iso-8859-14、iso-8859-15、koi8-r、koi8-u、macintosh、windows-874、windows-1250、windows-1251、windows-1252、windows-1253、windows-1254、windows-1255、windows-1256、windows-1257、windows-1258、x-mac-cyrilli、gbk、gb18030、big5、euc-jp、iso-2022-jp、shift_jis、euc-kr、utf-16be、utf-16le。 | | fatal | boolean | 是 | 否 | 是否显示致命错误。 | | ignoreBOM | boolean | 是 | 否 | 是否忽略BOM（byte order marker）标记，默认值为false ，表示解码结果包含BOM标记。 | ### constructor9+ constructor() TextDecoder的构造函数。 **系统能力：** SystemCapability.Utils.Lang ### create9+ create(encoding?: string,options?: { fatal?: boolean; ignoreBOM?: boolean }): TextDecoder; 替代有参构造功能。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ------------------------------------------------ | | encoding | string | 否 | 编码格式，默认值是'utf-8'。 | | options | Object | 否 | 编码相关选项参数，存在两个属性fatal和ignoreBOM。 | **表1.1**options | 名称 | 参数类型 | 必填 | 说明 | | --------- | -------- | ---- | ------------------ | | fatal | boolean | 否 | 是否显示致命错误，默认值是false。 | | ignoreBOM | boolean | 否 | 是否忽略BOM标记，默认值是false。 | **示例：** ```js let result = util.TextDecoder.create('utf-8', { ignoreBOM : true }) let retStr = result.encoding ``` ### decodeWithStream9+ decodeWithStream(input: Uint8Array, options?: { stream?: boolean }): string 通过输入参数解码后输出对应文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | input | Uint8Array | 是 | 符合格式需要解码的数组。 | | options | Object | 否 | 解码相关选项参数。 | **表2** options | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | stream | boolean | 否 | 在随后的decodeWithStream()调用中是否跟随附加数据块。如果以块的形式处理数据，则设置为true；如果处理最后的数据块或数据未分块，则设置为false。默认为false。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 解码后的数据。 | **示例：** ```js let textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true}); let result = new Uint8Array(6); result[0] = 0xEF; result[1] = 0xBB; result[2] = 0xBF; result[3] = 0x61; result[4] = 0x62; result[5] = 0x63; console.log("input num:"); let retStr = textDecoder.decodeWithStream( result , {stream: false}); console.log("retStr = " + retStr); ``` ### constructor(deprecated) constructor(encoding?: string, options?: { fatal?: boolean; ignoreBOM?: boolean }) TextDecoder的构造函数。 > **说明：** > > 从API version 7开始支持，从API version 9开始废弃，建议使用[create9+](#create9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | encoding | string | 否 | 编码格式，默认值是'utf-8'。 | | options | Object | 否 | 编码相关选项参数，存在两个属性fatal和ignoreBOM。 | **表1** options | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | fatal | boolean | 否 | 是否显示致命错误，默认值是false。 | | ignoreBOM | boolean | 否 | 是否忽略BOM标记，默认值是false。 | **示例：** ```js let textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true}); ``` ### decode(deprecated) decode(input: Uint8Array, options?: { stream?: false }): string 通过输入参数解码后输出对应文本。 > **说明：** > > 从API version 7开始支持，从API version 9开始废弃，建议使用[decodeWithStream9+](#decodewithstream9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | input | Uint8Array | 是 | 符合格式需要解码的数组。 | | options | Object | 否 | 解码相关选项参数。 | **表2** options | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | stream | boolean | 否 | 在随后的decode()调用中是否跟随附加数据块。如果以块的形式处理数据，则设置为true；如果处理最后的数据块或数据未分块，则设置为false。默认为false。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 解码后的数据。 | **示例：** ```js let textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true}); let result = new Uint8Array(6); result[0] = 0xEF; result[1] = 0xBB; result[2] = 0xBF; result[3] = 0x61; result[4] = 0x62; result[5] = 0x63; console.log("input num:"); let retStr = textDecoder.decode( result , {stream: false}); console.log("retStr = " + retStr); ``` ## TextEncoder TextEncoder用于将字符串编码为字节数组，支持多种编码格式，包括utf-8、utf-16le/be等。需要注意的是，在使用TextEncoder进行编码时，不同编码格式下字符所占的字节数是不同的。例如，utf-8编码下中文字符通常占3个字节，而utf-16le/be编码下中文字符通常占2个字节。因此，在使用TextEncoder时需要明确指定要使用的编码格式，以确保编码结果正确。 ### 属性 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Utils.Lang。 | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | encoding | string | 是 | 否 | 编码格式，默认值是'utf-8'。 | ### constructor constructor() TextEncoder的构造函数。 **系统能力：** SystemCapability.Utils.Lang **示例：** ```js let textEncoder = new util.TextEncoder(); ``` ### constructor9+ constructor(encoding?: string) TextEncoder的构造函数。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ---- | ---- | ---- | | encoding | string | 否 | 编码格式，默认值为'utf-8'。 | **示例：** ```js let textEncoder = new util.TextEncoder("utf-8"); ``` ### encodeInto9+ encodeInto(input?: string): Uint8Array 通过输入参数编码后输出对应文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------ | | input | string | 否 | 需要编码的字符串，默认值是空字符串。 | **返回值：** | 类型 | 说明 | | ---------- | ------------------ | | Uint8Array | 返回编码后的文本。 | **示例：** ```js let textEncoder = new util.TextEncoder(); let buffer = new ArrayBuffer(20); let result = new Uint8Array(buffer); result = textEncoder.encodeInto("\uD800¥¥"); ``` ### encodeIntoUint8Array9+ encodeIntoUint8Array(input: string, dest: Uint8Array, ): { read: number; written: number } 放置生成的UTF-8编码文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------- | ---- | ------------------------------------------------------- | | input | string | 是 | 需要编码的字符串。 | | dest | Uint8Array | 是 | Uint8Array对象实例，用于将生成的UTF-8编码文本放入其中。 | **返回值：** | 类型 | 说明 | | ---------- | ------------------ | | Uint8Array | 返回编码后的文本。 | **示例：** ```js let that = new util.TextEncoder() let buffer = new ArrayBuffer(4) let dest = new Uint8Array(buffer) let result = new Object() result = that.encodeIntoUint8Array('abcd', dest) ``` ### encodeInto(deprecated) encodeInto(input: string, dest: Uint8Array, ): { read: number; written: number } 放置生成的UTF-8编码文本。 > **说明：** > > 从API version 7开始支持，从API version 9开始废弃，建议使用[encodeIntoUint8Array9+](#encodeintouint8array9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | input | string | 是 | 需要编码的字符串。 | | dest | Uint8Array | 是 | Uint8Array对象实例，用于将生成的UTF-8编码文本放入其中。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Uint8Array | 返回编码后的文本。 | **示例：** ```js let that = new util.TextEncoder() let buffer = new ArrayBuffer(4) let dest = new Uint8Array(buffer) let result = new Object() result = that.encodeInto('abcd', dest) ``` ### encode(deprecated) encode(input?: string): Uint8Array 通过输入参数编码后输出对应文本。 > **说明：** > > 从API version 7开始支持，从API version 9开始废弃，建议使用[encodeInto9+](#encodeinto9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | input | string | 否 | 需要编码的字符串，默认值是空字符串。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Uint8Array | 返回编码后的文本。 | **示例：** ```js let textEncoder = new util.TextEncoder(); let buffer = new ArrayBuffer(20); let result = new Uint8Array(buffer); result = textEncoder.encode("\uD800¥¥"); ``` ## RationalNumber8+ RationalNumber主要是对有理数进行比较，获取分子分母等方法。例如使用toString()方法可以将有理数转换为字符串形式，使用该类可以方便地进行有理数的各种操作。 ### constructor9+ constructor() RationalNumber的构造函数。 **系统能力：** SystemCapability.Utils.Lang **示例：** ```js let rationalNumber = new util.RationalNumber(); ``` ### parseRationalNumber9+ parseRationalNumber(numerator: number,denominator: number): RationalNumber 替代原有参构造的参数处理。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------- | | numerator | number | 是 | 分子，整数类型。 | | denominator | number | 是 | 分母，整数类型。 | **示例：** ```js let rationalNumber = util.RationalNumber.parseRationalNumber(1,2) ``` ### createRationalFromString8+ static createRationalFromString​(rationalString: string): RationalNumber​ 基于给定的字符串创建一个RationalNumber对象。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | rationalString | string | 是 | 字符串格式。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | object | 返回有理数类的对象。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let rational = util.RationalNumber.createRationalFromString("3/4"); ``` ### compare9+ compare​(another: RationalNumber): number​ 将当前的RationalNumber对象与给定的对象进行比较。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------- | -------------- | ---- | ------------------ | | another | RationalNumber | 是 | 其他的有理数对象。 | **返回值：** | 类型 | 说明 | | ------ | ------------------------------------------------------------ | | number | 如果两个对象相等，则返回0；如果给定对象小于当前对象，则返回1；如果给定对象大于当前对象，则返回-1。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let rational = util.RationalNumber.createRationalFromString("3/4"); let result = rationalNumber.compare(rational); ``` ### valueOf8+ valueOf(): number 以整数形式或者浮点数的形式获取当前RationalNumber对象的值。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回整数或者浮点数的值。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = rationalNumber.valueOf(); ``` ### equals8+ equals​(obj: Object): boolean 将当前的RationalNumber对象与给定的对象进行比较是否相等。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | object | Object | 是 | 其他类型对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 如果给定对象与当前对象相同，则返回true；否则返回false。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let rational = util.RationalNumber.createRationalFromString("3/4"); let result = rationalNumber.equals(rational); ``` ### getCommonFactor9+ getCommonFactor(number1: number,number2: number): number 获取两个指定整数的最大公约数。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------- | ------ | ---- | ---------- | | number1 | number | 是 | 整数类型。 | | number2 | number | 是 | 整数类型。 | **返回值：** | 类型 | 说明 | | ------ | ------------------------------ | | number | 返回两个给定数字的最大公约数。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = util.RationalNumber.getCommonFactor(4,6); ``` ### getNumerator8+ getNumerator​(): number 获取当前RationalNumber对象的分子。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回RationalNumber对象的分子的值。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = rationalNumber.getNumerator(); ``` ### getDenominator8+ getDenominator​(): number 获取当前RationalNumber对象的分母。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回RationalNumber对象的分母的值。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = rationalNumber.getDenominator(); ``` ### isZero8+ isZero​():boolean 检查当前RationalNumber对象是否为0。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 如果当前对象表示的值为0，则返回true；否则返回false。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = rationalNumber.isZero(); ``` ### isNaN8+ isNaN​(): boolean 检查当前RationalNumber对象是否表示非数字(NaN)值。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 如果分母和分子都为0，则返回true；否则返回false。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = rationalNumber.isNaN(); ``` ### isFinite8+ isFinite​():boolean 检查当前RationalNumber对象是否表示一个有限值。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 如果分母不为0，则返回true；否则返回false。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = rationalNumber.isFinite(); ``` ### toString8+ toString​(): string 获取当前RationalNumber对象的字符串表示形式。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 返回Numerator/Denominator格式的字符串，例如3/5，如果当前对象的分子和分母都为0，则返回NaN。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = rationalNumber.toString(); ``` ### constructor(deprecated) constructor(numerator: number,denominator: number) RationalNumber的构造函数。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[constructor9+](#constructor9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | numerator | number | 是 | 分子，整数类型。 | | denominator | number | 是 | 分母，整数类型。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); ``` ### compareTo(deprecated) compareTo​(another: RationalNumber): number​ 将当前的RationalNumber对象与给定的对象进行比较。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[compare9+](#compare9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | another | RationalNumber | 是 | 其他的有理数对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 如果两个对象相等，则返回0；如果给定对象小于当前对象，则返回1；如果给定对象大于当前对象，则返回-1。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let rational = util.RationalNumber.createRationalFromString("3/4"); let result = rationalNumber.compareTo(rational); ``` ### getCommonDivisor(deprecated) static getCommonDivisor​(number1: number,number2: number): number 获取两个指定整数的最大公约数。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[getCommonFactor9+](#getcommonfactor9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | number1 | number | 是 | 整数类型。 | | number2 | number | 是 | 整数类型。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回两个给定数字的最大公约数。 | **示例：** ```js let rationalNumber = new util.RationalNumber(1,2); let result = util.RationalNumber.getCommonDivisor(4,6); ``` ## LRUCache9+ LRUCache用于在缓存空间不够的时候，将近期最少使用的数据替换为新数据。此设计基于资源访问的考虑：近期访问的数据，可能在不久的将来会再次访问。于是最少访问的数据就是价值最小的数据，是最应该踢出缓存空间的数据。 ### 属性 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Utils.Lang。 | 名称 | 类型 | 可读 | 可写 | 说明 | | ------ | ------ | ---- | ---- | ---------------------- | | length | number | 是 | 否 | 当前缓冲区中值的总数。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); pro.put(1,8); let result = pro.length; ``` ### constructor9+ constructor(capacity?: number) 默认构造函数用于创建一个新的LruBuffer实例，默认容量为64。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ---------------------------- | | capacity | number | 否 | 指示要为缓冲区自定义的容量。 | **示例：** ```js let lrubuffer= new util.LRUCache(); ``` ### updateCapacity9+ updateCapacity(newCapacity: number): void 将缓冲区容量更新为指定容量，如果newCapacity小于或等于0，则抛出异常。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------------------- | | newCapacity | number | 是 | 指示要为缓冲区自定义的容量。 | **示例：** ```js let pro = new util.LRUCache(); pro.updateCapacity(100); ``` ### toString9+ toString(): string 返回对象的字符串表示形式。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------ | -------------------------- | | string | 返回对象的字符串表示形式。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); pro.get(2); pro.remove(20); let result = pro.toString(); ``` ### getCapacity9+ getCapacity(): number 获取当前缓冲区的容量。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------ | ---------------------- | | number | 返回当前缓冲区的容量。 | **示例：** ```js let pro = new util.LRUCache(); let result = pro.getCapacity(); ``` ### clear9+ clear(): void 从当前缓冲区清除键值对。后续会调用afterRemoval()方法执行后续操作。 **系统能力：** SystemCapability.Utils.Lang **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let result = pro.length; pro.clear(); ``` ### getCreateCount9+ getCreateCount(): number 获取createDefault()返回值的次数。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------ | --------------------------------- | | number | 返回createDefault()返回值的次数。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(1,8); let result = pro.getCreateCount(); ``` ### getMissCount9+ getMissCount(): number 获取查询值不匹配的次数。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------ | ------------------------ | | number | 返回查询值不匹配的次数。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); pro.get(2); let result = pro.getMissCount(); ``` ### getRemovalCount9+ getRemovalCount(): number 获取从缓冲区中逐出值的次数。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------ | -------------------------- | | number | 返回从缓冲区中驱逐的次数。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); pro.updateCapacity(2); pro.put(50,22); let result = pro.getRemovalCount(); ``` ### getMatchCount9+ getMatchCount(): number 获取查询值匹配成功的次数。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------ | -------------------------- | | number | 返回查询值匹配成功的次数。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); pro.get(2); let result = pro.getMatchCount(); ``` ### getPutCount9+ getPutCount(): number 获取将值添加到缓冲区的次数。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------ | ---------------------------- | | number | 返回将值添加到缓冲区的次数。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let result = pro.getPutCount(); ``` ### isEmpty9+ isEmpty(): boolean 检查当前缓冲区是否为空。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------- | ---------------------------------------- | | boolean | 如果当前缓冲区不包含任何值，则返回true。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let result = pro.isEmpty(); ``` ### get9+ get(key: K): V | undefined 表示要查询的键。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---- | ---- | ------------ | | key | K | 是 | 要查询的键。 | **返回值：** | 类型 | 说明 | | ------------------------ | ------------------------------------------------------------ | | V \| undefined | 如果指定的键存在于缓冲区中，则返回与键关联的值；否则返回undefined。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let result = pro.get(2); ``` ### put9+ put(key: K,value: V): V 将键值对添加到缓冲区。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---- | ---- | -------------------------- | | key | K | 是 | 要添加的密钥。 | | value | V | 是 | 指示与要添加的键关联的值。 | **返回值：** | 类型 | 说明 | | ---- | ------------------------------------------------------------ | | V | 返回与添加的键关联的值；如果要添加的键已经存在，则返回原始值，如果键或值为空，则抛出此异常。 | **示例：** ```js let pro = new util.LRUCache(); let result = pro.put(2,10); ``` ### values9+ values(): V[] 获取当前缓冲区中所有值从最近访问到最近最少访问的顺序列表 。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | --------- | ------------------------------------------------------------ | | V [] | 按从最近访问到最近最少访问的顺序返回当前缓冲区中所有值的列表。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); pro.put(2,"anhu"); pro.put("afaf","grfb"); let result = pro.values(); ``` ### keys9+ keys(): K[] 获取当前缓冲区中所有键从最近访问到最近最少访问的升序列表。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | --------- | ------------------------------------------------------------ | | K [] | 按升序返回当前缓冲区中所有键的列表，从最近访问到最近最少访问。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let result = pro.keys(); ``` ### remove9+ remove(key: K): V | undefined 从当前缓冲区中删除指定的键及其关联的值。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---- | ---- | -------------- | | key | K | 是 | 要删除的密钥。 | **返回值：** | 类型 | 说明 | | ------------------------ | ------------------------------------------------------------ | | V \| undefined | 返回一个包含已删除键值对的Optional对象；如果key不存在，则返回一个空的Optional对象，如果key为null，则抛出异常。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let result = pro.remove(20); ``` ### afterRemoval9+ afterRemoval(isEvict: boolean,key: K,value: V,newValue: V): void 删除值后执行后续操作。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------- | ---- | ------------------------------------------------------------ | | isEvict | boolean | 是 | 因容量不足而调用该方法时，参数值为true，其他情况为false。 | | key | K | 是 | 表示删除的键。 | | value | V | 是 | 表示删除的值。 | | newValue | V | 是 | 如果已调用put方法并且要添加的键已经存在，则参数值是关联的新值。其他情况下参数值为空。 | **示例：** ```js let arr = []; class ChildLruBuffer extends util.LRUCache { constructor() { super(); } afterRemoval(isEvict, key, value, newValue) { if (isEvict === false) { arr = [key, value, newValue]; } } } let lru = new ChildLruBuffer(); lru.afterRemoval(false,10,30,null); ``` ### contains9+ contains(key: K): boolean 检查当前缓冲区是否包含指定的键。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---------------- | | key | K | 是 | 表示要检查的键。 | **返回值：** | 类型 | 说明 | | ------- | ------------------------------------------ | | boolean | 如果缓冲区包含指定的键，则返回 true。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let obj = {1:"key"}; let result = pro.contains(obj); ``` ### createDefault9+ createDefault(key: K): V 如果未计算特定键的值，则执行后续操作，参数表示丢失的键，返回与键关联的值。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---- | ---- | -------------- | | key | K | 是 | 表示丢失的键。 | **返回值：** | 类型 | 说明 | | ---- | ------------------ | | V | 返回与键关联的值。 | **示例：** ```js let pro = new util.LRUCache(); let result = pro.createDefault(50); ``` ### entries9+ entries(): IterableIterator<[K,V]> 允许迭代包含在这个对象中的所有键值对。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ----------- | -------------------- | | [K, V] | 返回一个可迭代数组。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let result = pro.entries(); ``` ### [Symbol.iterator]9+ [Symbol.iterator]\(): IterableIterator<[K, V]> 返回一个键值对形式的二维数组。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ----------- | ------------------------------ | | [K, V] | 返回一个键值对形式的二维数组。 | **示例：** ```js let pro = new util.LRUCache(); pro.put(2,10); let result = pro[Symbol.iterator](); ``` ## ScopeComparable8+ ScopeComparable类型的值需要实现compareTo方法，确保传入的数据具有可比性。 **系统能力：** SystemCapability.Utils.Lang ### compareTo8+ compareTo(other: ScopeComparable): boolean; 比较两个值的大小，返回一个布尔值。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---- | ---- | -------------- | | other | [ScopeComparable](#scopecomparable8) | 是 | 表示要比较的值。 | **返回值：** | 类型 | 说明 | | ---- | ------------------ | | boolean | 调用compareTo的值大于等于传入的值返回true，否则返回false。| **示例：** 构造新类，实现compareTo方法。后续示例代码中，均以此Temperature类为例。 ```js class Temperature{ // 当使用ArkTS语言开发时，需要补充以下代码： // private readonly _temp: Temperature; constructor(value) { this._temp = value; } compareTo(value) { return this._temp >= value.getTemp(); } getTemp() { return this._temp; } toString() { return this._temp.toString(); } } ``` ## ScopeType8+ 用于表示范围中的值的类型。 **系统能力：** SystemCapability.Utils.Lang | 类型 | 说明 | | -------- | -------- | | number | 表示值的类型为数字。 | | [ScopeComparable](#scopecomparable8) | 表示值的类型为ScopeComparable。| ## ScopeHelper9+ ScopeHelper接口用于描述一个字段的有效范围。ScopeHelper实例的构造函数用于创建具有指定下限和上限的对象，并要求这些对象必须具有可比性。 ### constructor9+ constructor(lowerObj: ScopeType, upperObj: ScopeType) 用于创建指定下限和上限的作用域实例的构造函数，返回一个ScopeHelper对象。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------ | ---- | ---------------------- | | lowerObj | [ScopeType](#scopetype8) | 是 | 指定作用域实例的下限。 | | upperObj | [ScopeType](#scopetype8) | 是 | 指定作用域实例的上限。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.ScopeHelper(tempLower, tempUpper); ``` ### toString9+ toString(): string 该字符串化方法返回一个包含当前范围的字符串表示形式。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------ | -------------------------------------- | | string | 返回包含当前范围对象的字符串表示形式。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.ScopeHelper(tempLower, tempUpper); let result = range.toString(); ``` ### intersect9+ intersect(range: ScopeHelper): ScopeHelper 获取给定范围和当前范围的交集。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------- | ---- | ------------------ | | range | [ScopeHelper](#scopehelper9) | 是 | 传入一个给定范围。 | **返回值：** | 类型 | 说明 | | ------------------------------ | ------------------------------ | | [ScopeHelper9+](#scopehelper9) | 返回给定范围和当前范围的交集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.ScopeHelper(tempLower, tempUpper); let tempMiDF = new Temperature(35); let tempMidS = new Temperature(39); let rangeFir = new util.ScopeHelper(tempMiDF, tempMidS); range.intersect(rangeFir); ``` ### intersect9+ intersect(lowerObj:ScopeType,upperObj:ScopeType):ScopeHelper 获取当前范围与给定下限和上限范围的交集。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------ | ---- | ---------------- | | lowerObj | [ScopeType](#scopetype8) | 是 | 给定范围的下限。 | | upperObj | [ScopeType](#scopetype8) | 是 | 给定范围的上限。 | **返回值：** | 类型 | 说明 | | ---------------------------- | ---------------------------------------- | | [ScopeHelper](#scopehelper9) | 返回当前范围与给定下限和上限范围的交集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let tempMidS = new Temperature(39); let range = new util.ScopeHelper(tempLower, tempUpper); let result = range.intersect(tempMiDF, tempMidS); ``` ### getUpper9+ getUpper(): ScopeType 获取当前范围的上限。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------------------------ | ---------------------- | | [ScopeType](#scopetype8) | 返回当前范围的上限值。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.ScopeHelper(tempLower, tempUpper); let result = range.getUpper(); ``` ### getLower9+ getLower(): ScopeType 获取当前范围的下限。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | ------------------------ | ---------------------- | | [ScopeType](#scopetype8) | 返回当前范围的下限值。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.ScopeHelper(tempLower, tempUpper); let result = range.getLower(); ``` ### expand9+ expand(lowerObj: ScopeType,upperObj: ScopeType): ScopeHelper 创建并返回包括当前范围和给定下限和上限的并集。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------ | ---- | ---------------- | | lowerObj | [ScopeType](#scopetype8) | 是 | 给定范围的下限。 | | upperObj | [ScopeType](#scopetype8) | 是 | 给定范围的上限。 | **返回值：** | 类型 | 说明 | | ---------------------------- | ------------------------------------ | | [ScopeHelper](#scopehelper9) | 返回当前范围和给定下限和上限的并集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let tempMidS = new Temperature(39); let range = new util.ScopeHelper(tempLower, tempUpper); let result = range.expand(tempMiDF, tempMidS); ``` ### expand9+ expand(range: ScopeHelper): ScopeHelper 创建并返回包括当前范围和给定范围的并集。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------- | ---- | ------------------ | | range | [ScopeHelper](#scopehelper9) | 是 | 传入一个给定范围。 | **返回值：** | 类型 | 说明 | | ---------------------------- | ---------------------------------- | | [ScopeHelper](#scopehelper9) | 返回包括当前范围和给定范围的并集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let tempMidS = new Temperature(39); let range = new util.ScopeHelper(tempLower, tempUpper); let rangeFir = new util.ScopeHelper(tempMiDF, tempMidS); let result = range.expand(rangeFir); ``` ### expand9+ expand(value: ScopeType): ScopeHelper 创建并返回包括当前范围和给定值的并集。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------ | ---- | ---------------- | | value | [ScopeType](#scopetype8) | 是 | 传入一个给定值。 | **返回值：** | 类型 | 说明 | | ---------------------------- | -------------------------------- | | [ScopeHelper](#scopehelper9) | 返回包括当前范围和给定值的并集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let range = new util.ScopeHelper(tempLower, tempUpper); let result = range.expand(tempMiDF); ``` ### contains9+ contains(value: ScopeType): boolean 检查给定value是否包含在当前范围内。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------ | ---- | ---------------- | | value | [ScopeType](#scopetype8) | 是 | 传入一个给定值。 | **返回值：** | 类型 | 说明 | | ------- | --------------------------------------------------- | | boolean | 如果给定值包含在当前范围内返回true，否则返回false。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let range = new util.ScopeHelper(tempLower, tempUpper); let result = range.contains(tempMiDF); ``` ### contains9+ contains(range: ScopeHelper): boolean 检查给定range是否在当前范围内。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------- | ---- | ------------------ | | range | [ScopeHelper](#scopehelper9) | 是 | 传入一个给定范围。 | **返回值：** | 类型 | 说明 | | ------- | ----------------------------------------------------- | | boolean | 如果给定范围包含在当前范围内返回true，否则返回false。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.ScopeHelper(tempLower, tempUpper); let tempLess = new Temperature(20); let tempMore = new Temperature(45); let rangeSec = new util.ScopeHelper(tempLess, tempMore); let result = range.contains(rangeSec); ``` ### clamp9+ clamp(value: ScopeType): ScopeType 将给定值限定到当前范围内。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------ | ---- | -------------- | | value | [ScopeType](#scopetype8) | 是 | 传入的给定值。 | **返回值：** | 类型 | 说明 | | ------------------------ | ------------------------------------------------------------ | | [ScopeType](#scopetype8) | 如果传入的value小于下限，则返回lowerObj；如果大于上限值则返回upperObj；如果在当前范围内，则返回value。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let range = new util.ScopeHelper(tempLower, tempUpper); let result = range.clamp(tempMiDF); ``` ## Base64Helper9+ Base64编码表包含A-Z、a-z、0-9这62个字符，以及"+"和"/"这两个特殊字符。在编码时，将原始数据按3个字节一组进行划分，得到若干个6位的数字，然后使用Base64编码表中对应的字符来表示这些数字。如果最后剩余1或2个字节，则需要使用"="字符进行补齐。 ### constructor9+ constructor() Base64Helper的构造函数。 **系统能力：** SystemCapability.Utils.Lang **示例：** ```js let base64 = new util.Base64Helper(); ``` ### encodeSync9+ encodeSync(src: Uint8Array): Uint8Array 通过输入参数编码后输出对应文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------- | ---- | ------------------- | | src | Uint8Array | 是 | 编码输入Uint8数组。 | **返回值：** | 类型 | 说明 | | ---------- | ----------------------------- | | Uint8Array | 返回编码后新分配的Uint8数组。 | **示例：** ```js let that = new util.Base64Helper(); let array = new Uint8Array([115,49,51]); let result = that.encodeSync(array); ``` ### encodeToStringSync9+ encodeToStringSync(src: Uint8Array): string 通过输入参数编码后输出对应文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------- | ---- | ------------------- | | src | Uint8Array | 是 | 编码输入Uint8数组。 | **返回值：** | 类型 | 说明 | | ------ | -------------------- | | string | 返回编码后的字符串。 | **示例：** ```js let that = new util.Base64Helper(); let array = new Uint8Array([115,49,51]); let result = that.encodeToStringSync(array); ``` ### decodeSync9+ decodeSync(src: Uint8Array | string): Uint8Array 通过输入参数解码后输出对应文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------------ | ---- | ----------------------------- | | src | Uint8Array \| string | 是 | 解码输入Uint8数组或者字符串。 | **返回值：** | 类型 | 说明 | | ---------- | ----------------------------- | | Uint8Array | 返回解码后新分配的Uint8数组。 | **示例：** ```js let that = new util.Base64Helper(); let buff = 'czEz'; let result = that.decodeSync(buff); ``` ### encode9+ encode(src: Uint8Array): Promise<Uint8Array> 通过输入参数异步编码后输出对应文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------- | ---- | ----------------------- | | src | Uint8Array | 是 | 异步编码输入Uint8数组。 | **返回值：** | 类型 | 说明 | | ------------------------- | --------------------------------- | | Promise<Uint8Array> | 返回异步编码后新分配的Uint8数组。 | **示例：** ```js let that = new util.Base64Helper(); let array = new Uint8Array([115,49,51]); let rarray = new Uint8Array([99,122,69,122]); that.encode(array).then(val=>{ for (var i = 0; i < rarray.length; i++) { console.log(val[i].toString()) } }) ``` ### encodeToString9+ encodeToString(src: Uint8Array): Promise<string> 通过输入参数异步编码后输出对应文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------- | ---- | ----------------------- | | src | Uint8Array | 是 | 异步编码输入Uint8数组。 | **返回值：** | 类型 | 说明 | | --------------------- | ------------------------ | | Promise<string> | 返回异步编码后的字符串。 | **示例：** ```js let that = new util.Base64Helper(); let array = new Uint8Array([115,49,51]); that.encodeToString(array).then(val=>{ console.log(val) }) ``` ### decode9+ decode(src: Uint8Array | string): Promise<Uint8Array> 通过输入参数异步解码后输出对应文本。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------------ | ---- | --------------------------------- | | src | Uint8Array \| string | 是 | 异步解码输入Uint8数组或者字符串。 | **返回值：** | 类型 | 说明 | | ------------------------- | --------------------------------- | | Promise<Uint8Array> | 返回异步解码后新分配的Uint8数组。 | **示例：** ```js let that = new util.Base64Helper(); let array = new Uint8Array([99,122,69,122]); let rarray = new Uint8Array([115,49,51]); that.decode(array).then(val=>{ for (var i = 0; i < rarray.length; i++) { console.log(val[i].toString()) } }) ``` ## types8+ types为不同类型的内置对象提供类型检查，可以避免由于类型错误导致的异常或崩溃。该模块包含了多个工具函数，用于判断JS对象是否属于各种类型例如：ArrayBuffer、Map、Set等。 ### constructor8+ constructor() Types的构造函数。 **系统能力：** SystemCapability.Utils.Lang **示例：** ```js let type = new util.types(); ``` ### isAnyArrayBuffer8+ isAnyArrayBuffer(value: Object): boolean 检查输入的value是否是ArrayBuffer类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是ArrayBuffer类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isAnyArrayBuffer(new ArrayBuffer(0)); ``` ### isArrayBufferView8+ isArrayBufferView(value: Object): boolean 检查输入的value是否是内置ArrayBufferView辅助类型。 ArrayBufferView辅助类型包括：Int8Array、Int16Array、Int32Array、Uint8Array、Uint8ClampedArray、Uint32Array、Float32Array、Float64Array、DataView。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的ArrayBufferView辅助类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isArrayBufferView(new Int8Array([])); ``` ### isArgumentsObject8+ isArgumentsObject(value: Object): boolean 检查输入的value是否是一个arguments对象类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的arguments类型为true，反之为false。 | **示例：** ```js let that = new util.types(); function foo() { var result = that.isArgumentsObject(arguments); } let f = foo(); ``` ### isArrayBuffer8+ isArrayBuffer(value: Object): boolean 检查输入的value是否是ArrayBuffer类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的ArrayBuffer类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isArrayBuffer(new ArrayBuffer(0)); ``` ### isAsyncFunction8+ isAsyncFunction(value: Object): boolean 检查输入的value是否是一个异步函数类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的异步函数类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isAsyncFunction(async function foo() {}); ``` ### isBooleanObject8+ isBooleanObject(value: Object): boolean 检查输入的value是否是一个Boolean对象类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Boolean对象类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isBooleanObject(new Boolean(true)); ``` ### isBoxedPrimitive8+ isBoxedPrimitive(value: Object): boolean 检查输入的value是否是Boolean或Number或String或Symbol对象类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Boolean或Number或String或Symbol对象类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isBoxedPrimitive(new Boolean(false)); ``` ### isDataView8+ isDataView(value: Object): boolean 检查输入的value是否是DataView类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的DataView对象类型为true，反之为false。 | **示例：** ```js let that = new util.types(); const ab = new ArrayBuffer(20); let result = that.isDataView(new DataView(ab)); ``` ### isDate8+ isDate(value: Object): boolean 检查输入的value是否是Date类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Date对象类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isDate(new Date()); ``` ### isExternal8+ isExternal(value: Object): boolean 检查输入的value是否是native External类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含native External类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isExternal(true); ``` ### isFloat32Array8+ isFloat32Array(value: Object): boolean 检查输入的value是否是Float32Array数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Float32Array数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isFloat32Array(new Float32Array()); ``` ### isFloat64Array8+ isFloat64Array(value: Object): boolean 检查输入的value是否是Float64Array数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Float64Array数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isFloat64Array(new Float64Array()); ``` ### isGeneratorFunction8+ isGeneratorFunction(value: Object): boolean 检查输入的value是否是generator函数类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的generator函数类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isGeneratorFunction(function* foo() {}); ``` ### isGeneratorObject8+ isGeneratorObject(value: Object): boolean 检查输入的value是否是generator对象类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的generator对象类型为true，反之为false。 | **示例：** ```js let that = new util.types(); function* foo() {} const generator = foo(); let result = that.isGeneratorObject(generator); ``` ### isInt8Array8+ isInt8Array(value: Object): boolean 检查输入的value是否是Int8Array数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Int8Array数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isInt8Array(new Int8Array([])); ``` ### isInt16Array8+ isInt16Array(value: Object): boolean 检查输入的value是否是Int16Array数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Int16Array数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isInt16Array(new Int16Array([])); ``` ### isInt32Array8+ isInt32Array(value: Object): boolean 检查输入的value是否是Int32Array数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Int32Array数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isInt32Array(new Int32Array([])); ``` ### isMap8+ isMap(value: Object): boolean 检查输入的value是否是Map类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Map类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isMap(new Map()); ``` ### isMapIterator8+ isMapIterator(value: Object): boolean 检查输入的value是否是Map的Iterator类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Map的Iterator类型为true，反之为false。 | **示例：** ```js let that = new util.types(); const map = new Map(); let result = that.isMapIterator(map.keys()); ``` ### isNativeError8+ isNativeError(value: Object): boolean 检查输入的value是否是Error类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Error类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isNativeError(new TypeError()); ``` ### isNumberObject8+ isNumberObject(value: Object): boolean 检查输入的value是否是Number对象类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Number对象类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isNumberObject(new Number(0)); ``` ### isPromise8+ isPromise(value: Object): boolean 检查输入的value是否是Promise类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Promise类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isPromise(Promise.resolve(1)); ``` ### isProxy8+ isProxy(value: Object): boolean 检查输入的value是否是Proxy类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Proxy类型为true，反之为false。 | **示例：** ```js let that = new util.types(); const target = {}; const proxy = new Proxy(target, {}); let result = that.isProxy(proxy); ``` ### isRegExp8+ isRegExp(value: Object): boolean 检查输入的value是否是RegExp类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的RegExp类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isRegExp(new RegExp('abc')); ``` ### isSet8+ isSet(value: Object): boolean 检查输入的value是否是Set类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Set类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isSet(new Set()); ``` ### isSetIterator8+ isSetIterator(value: Object): boolean 检查输入的value是否是Set的Iterator类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Set的Iterator类型为true，反之为false。 | **示例：** ```js let that = new util.types(); const set = new Set(); let result = that.isSetIterator(set.keys()); ``` ### isStringObject8+ isStringObject(value: Object): boolean 检查输入的value是否是String对象类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的String对象类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isStringObject(new String('foo')); ``` ### isSymbolObjec8+ isSymbolObject(value: Object): boolean 检查输入的value是否是Symbol对象类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Symbol对象类型为true，反之为false。 | **示例：** ```js let that = new util.types(); const symbols = Symbol('foo'); let result = that.isSymbolObject(Object(symbols)); ``` ### isTypedArray8+ isTypedArray(value: Object): boolean 检查输入的value是否是TypedArray类型的辅助类型。 TypedArray类型的辅助类型，包括Int8Array、Int16Array、Int32Array、Uint8Array、Uint8ClampedArray、Uint16Array、Uint32Array、Float32Array、Float64Array、DataView。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的TypedArray包含的类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isTypedArray(new Float64Array([])); ``` ### isUint8Array8+ isUint8Array(value: Object): boolean 检查输入的value是否是Uint8Array数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Uint8Array数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isUint8Array(new Uint8Array([])); ``` ### isUint8ClampedArray8+ isUint8ClampedArray(value: Object): boolean 检查输入的value是否是Uint8ClampedArray数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Uint8ClampedArray数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isUint8ClampedArray(new Uint8ClampedArray([])); ``` ### isUint16Array8+ isUint16Array(value: Object): boolean 检查输入的value是否是Uint16Array数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Uint16Array数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isUint16Array(new Uint16Array([])); ``` ### isUint32Array8+ isUint32Array(value: Object): boolean 检查输入的value是否是Uint32Array数组类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Uint32Array数组类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isUint32Array(new Uint32Array([])); ``` ### isWeakMap8+ isWeakMap(value: Object): boolean 检查输入的value是否是WeakMap类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的WeakMap类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isWeakMap(new WeakMap()); ``` ### isWeakSet8+ isWeakSet(value: Object): boolean 检查输入的value是否是WeakSet类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的WeakSet类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isWeakSet(new WeakSet()); ``` ### isBigInt64Array8+ isBigInt64Array(value: Object): boolean 检查输入的value是否是BigInt64Array类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的BigInt64Array类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isBigInt64Array(new BigInt64Array([])); ``` ### isBigUint64Array8+ isBigUint64Array(value: Object): boolean 检查输入的value是否是BigUint64Array类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的BigUint64Array类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isBigUint64Array(new BigUint64Array([])); ``` ### isModuleNamespaceObject8+ isModuleNamespaceObject(value: Object): boolean 检查输入的value是否是Module Namespace Object类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的Module Namespace Object类型为true，反之为false。 | **示例：** ```js import url from '@ohos.url' let that = new util.types(); let result = that.isModuleNamespaceObject(url); ``` ### isSharedArrayBuffer8+ isSharedArrayBuffer(value: Object): boolean 检查输入的value是否是SharedArrayBuffer类型。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | Object | 是 | 待检测对象。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 判断的结果，如果是内置包含的SharedArrayBuffer类型为true，反之为false。 | **示例：** ```js let that = new util.types(); let result = that.isSharedArrayBuffer(new SharedArrayBuffer(0)); ``` ## LruBuffer(deprecated) > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache9+](#lrucache9)替代。 ### 属性 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Utils.Lang。 | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | 当前缓冲区中值的总数。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); pro.put(1,8); let result = pro.length; ``` ### constructor(deprecated) constructor(capacity?: number) 默认构造函数用于创建一个新的LruBuffer实例，默认容量为64。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.constructor9+](#constructor9-3)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | capacity | number | 否 | 指示要为缓冲区自定义的容量。 | **示例：** ```js let lrubuffer= new util.LruBuffer(); ``` ### updateCapacity(deprecated) updateCapacity(newCapacity: number): void 将缓冲区容量更新为指定容量，如果newCapacity小于或等于0，则抛出异常。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.updateCapacity9+](#updatecapacity9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | newCapacity | number | 是 | 指示要为缓冲区自定义的容量。 | **示例：** ```js let pro = new util.LruBuffer(); let result = pro.updateCapacity(100); ``` ### toString(deprecated) toString(): string 返回对象的字符串表示形式。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.toString9+](#tostring9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 返回对象的字符串表示形式。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); pro.get(2); pro.remove(20); let result = pro.toString(); ``` ### getCapacity(deprecated) getCapacity(): number 获取当前缓冲区的容量。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getCapacity9+](#getcapacity9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回当前缓冲区的容量。 | **示例：** ```js let pro = new util.LruBuffer(); let result = pro.getCapacity(); ``` ### clear(deprecated) clear(): void 从当前缓冲区清除键值对。后续会调用afterRemoval()方法执行后续操作。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.clear9+](#clear9)替代。 **系统能力：** SystemCapability.Utils.Lang **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro.length; pro.clear(); ``` ### getCreateCount(deprecated) getCreateCount(): number 获取createDefault()返回值的次数。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getCreateCount9+](#getcreatecount9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回createDefault()返回值的次数。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(1,8); let result = pro.getCreateCount(); ``` ### getMissCount(deprecated) getMissCount(): number 获取查询值不匹配的次数。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getMissCount9+](#getmisscount9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回查询值不匹配的次数。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); pro.get(2); let result = pro.getMissCount(); ``` ### getRemovalCount(deprecated) getRemovalCount(): number 获取从缓冲区中逐出值的次数。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getRemovalCount9+](#getremovalcount9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回从缓冲区中驱逐的次数。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); pro.updateCapacity(2); pro.put(50,22); let result = pro.getRemovalCount(); ``` ### getMatchCount(deprecated) getMatchCount(): number 获取查询值匹配成功的次数。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getMatchCount9+](#getmatchcount9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回查询值匹配成功的次数。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); pro.get(2); let result = pro.getMatchCount(); ``` ### getPutCount(deprecated) getPutCount(): number 获取将值添加到缓冲区的次数。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getPutCount9+](#getputcount9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | number | 返回将值添加到缓冲区的次数。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro.getPutCount(); ``` ### isEmpty(deprecated) isEmpty(): boolean 检查当前缓冲区是否为空。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.isEmpty9+](#isempty9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 如果当前缓冲区不包含任何值，则返回true。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro.isEmpty(); ``` ### get(deprecated) get(key: K): V | undefined 表示要查询的键。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.get9+](#get9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | key | K | 是 | 要查询的键。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | V \| undefined | 如果指定的键存在于缓冲区中，则返回与键关联的值；否则返回undefined。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro.get(2); ``` ### put(deprecated) put(key: K,value: V): V 将键值对添加到缓冲区。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.put9+](#put9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | key | K | 是 | 要添加的密钥。 | | value | V | 是 | 指示与要添加的键关联的值。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | V | 返回与添加的键关联的值；如果要添加的键已经存在，则返回原始值，如果键或值为空，则抛出此异常。 | **示例：** ```js let pro = new util.LruBuffer(); let result = pro.put(2,10); ``` ### values(deprecated) values(): V[] 获取当前缓冲区中所有值从最近访问到最近最少访问的顺序列表。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.values9+](#values9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | V [] | 按从最近访问到最近最少访问的顺序返回当前缓冲区中所有值的列表。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); pro.put(2,"anhu"); pro.put("afaf","grfb"); let result = pro.values(); ``` ### keys(deprecated) keys(): K[] 获取当前缓冲区中所有键从最近访问到最近最少访问的升序列表。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.keys9+](#keys9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | K [] | 按升序返回当前缓冲区中所有键的列表，从最近访问到最近最少访问。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro.keys(); ``` ### remove(deprecated) remove(key: K): V | undefined 从当前缓冲区中删除指定的键及其关联的值。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.remove9+](#remove9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | key | K | 是 | 要删除的密钥。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | V \| undefined | 返回一个包含已删除键值对的Optional对象；如果key不存在，则返回一个空的Optional对象，如果key为null，则抛出异常。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro.remove(20); ``` ### afterRemoval(deprecated) afterRemoval(isEvict: boolean,key: K,value: V,newValue: V): void 删除值后执行后续操作。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.afterRemoval9+](#afterremoval9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | isEvict | boolean | 是 | 因容量不足而调用该方法时，参数值为true，其他情况为false。 | | key | K | 是 | 表示删除的键。 | | value | V | 是 | 表示删除的值。 | | newValue | V | 是 | 如果已调用put方法并且要添加的键已经存在，则参数值是关联的新值。其他情况下参数值为空。 | **示例：** ```js let arr = []; class ChildLruBuffer extends util.LruBuffer { constructor() { super(); } afterRemoval(isEvict, key, value, newValue) { if (isEvict === false) { arr = [key, value, newValue]; } } } let lru = new ChildLruBuffer(); lru.afterRemoval(false,10,30,null); ``` ### contains(deprecated) contains(key: K): boolean 检查当前缓冲区是否包含指定的键。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.contains9+](#contains9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | key | K | 是 | 表示要检查的键。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 如果缓冲区包含指定的键，则返回 true。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro.contains(20); ``` ### createDefault(deprecated) createDefault(key: K): V 如果未计算特定键的值，则执行后续操作，参数表示丢失的键，返回与键关联的值。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.createDefault9+](#createdefault9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | key | K | 是 | 表示丢失的键。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | V | 返回与键关联的值。 | **示例：** ```js let pro = new util.LruBuffer(); let result = pro.createDefault(50); ``` ### entries(deprecated) entries(): IterableIterator<[K,V]> 允许迭代包含在这个对象中的所有键值对。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.entries9+](#entries9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | [K, V] | 返回一个可迭代数组。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro.entries(); ``` ### [Symbol.iterator](deprecated) [Symbol.iterator]\(): IterableIterator<[K, V]> 返回一个键值对形式的二维数组。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.Symbol.iterator9+](#symboliterator9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | [K, V] | 返回一个键值对形式的二维数组。 | **示例：** ```js let pro = new util.LruBuffer(); pro.put(2,10); let result = pro[Symbol.iterator](); ``` ## Scope(deprecated) > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper9+](#scopehelper9)替代。 ### constructor(deprecated) constructor(lowerObj: ScopeType, upperObj: ScopeType) 用于创建指定下限和上限的作用域实例的构造函数，返回一个Scope对象。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.constructor9+](#constructor9-4)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | lowerObj | [ScopeType](#scopetype8) | 是 | 指定作用域实例的下限。 | | upperObj | [ScopeType](#scopetype8) | 是 | 指定作用域实例的上限。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.Scope(tempLower, tempUpper); ``` ### toString(deprecated) toString(): string 该字符串化方法返回一个包含当前范围的字符串表示形式。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.toString9+](#tostring9-1)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 返回包含当前范围对象的字符串表示形式。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.Scope(tempLower, tempUpper); let result = range.toString(); ``` ### intersect(deprecated) intersect(range: Scope): Scope 获取给定范围和当前范围的交集。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.intersect9+](#intersect9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | range | [Scope](#scopedeprecated) | 是 | 传入一个给定范围。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | [Scope](#scopedeprecated) | 返回给定范围和当前范围的交集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.Scope(tempLower, tempUpper); let tempMiDF = new Temperature(35); let tempMidS = new Temperature(39); let rangeFir = new util.Scope(tempMiDF, tempMidS); range.intersect(rangeFir ); ``` ### intersect(deprecated) intersect(lowerObj:ScopeType,upperObj:ScopeType):Scope 获取当前范围与给定下限和上限范围的交集。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.intersect9+](#intersect9-1)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | lowerObj | [ScopeType](#scopetype8) | 是 | 给定范围的下限。 | | upperObj | [ScopeType](#scopetype8) | 是 | 给定范围的上限。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | [Scope](#scopedeprecated) | 返回当前范围与给定下限和上限范围的交集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let tempMidS = new Temperature(39); let range = new util.Scope(tempLower, tempUpper); let result = range.intersect(tempMiDF, tempMidS); ``` ### getUpper(deprecated) getUpper(): ScopeType 获取当前范围的上限。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.getUpper9+](#getupper9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | [ScopeType](#scopetype8) | 返回当前范围的上限值。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.Scope(tempLower, tempUpper); let result = range.getUpper(); ``` ### getLower(deprecated) getLower(): ScopeType 获取当前范围的下限。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.getLower9+](#getlower9)替代。 **系统能力：** SystemCapability.Utils.Lang **返回值：** | 类型 | 说明 | | -------- | -------- | | [ScopeType](#scopetype8) | 返回当前范围的下限值。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.Scope(tempLower, tempUpper); let result = range.getLower(); ``` ### expand(deprecated) expand(lowerObj: ScopeType,upperObj: ScopeType): Scope 创建并返回包括当前范围和给定下限和上限的并集。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.expand9+](#expand9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | lowerObj | [ScopeType](#scopetype8) | 是 | 给定范围的下限。 | | upperObj | [ScopeType](#scopetype8) | 是 | 给定范围的上限。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | [Scope](#scopedeprecated) | 返回当前范围和给定下限和上限的并集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let tempMidS = new Temperature(39); let range = new util.Scope(tempLower, tempUpper); let result = range.expand(tempMiDF, tempMidS); ``` ### expand(deprecated) expand(range: Scope): Scope 创建并返回包括当前范围和给定范围的并集。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.expand9+](#expand9-1)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | range | [Scope](#scopedeprecated) | 是 | 传入一个给定范围。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | [Scope](#scopedeprecated) | 返回包括当前范围和给定范围的并集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let tempMidS = new Temperature(39); let range = new util.Scope(tempLower, tempUpper); let rangeFir = new util.Scope(tempMiDF, tempMidS); let result = range.expand(rangeFir); ``` ### expand(deprecated) expand(value: ScopeType): Scope 创建并返回包括当前范围和给定值的并集。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.expand9+](#expand9-2)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | [ScopeType](#scopetype8) | 是 | 传入一个给定值。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | [Scope](#scopedeprecated) | 返回包括当前范围和给定值的并集。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let range = new util.Scope(tempLower, tempUpper); let result = range.expand(tempMiDF); ``` ### contains(deprecated) contains(value: ScopeType): boolean 检查给定value是否包含在当前范围内。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.contains9+](#contains9-1)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | [ScopeType](#scopetype8) | 是 | 传入一个给定值。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 如果给定值包含在当前范围内返回true，否则返回false。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let range = new util.Scope(tempLower, tempUpper); range.contains(tempMiDF); ``` ### contains(deprecated) contains(range: Scope): boolean 检查给定range是否在当前范围内。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.contains9+](#contains9-2)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | range | [Scope](#scopedeprecated) | 是 | 传入一个给定范围。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | boolean | 如果给定范围包含在当前范围内返回true，否则返回false。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let range = new util.Scope(tempLower, tempUpper); let tempLess = new Temperature(20); let tempMore = new Temperature(45); let rangeSec = new util.Scope(tempLess, tempMore); let result = range.contains(rangeSec); ``` ### clamp(deprecated) clamp(value: ScopeType): ScopeType 将给定值限定到当前范围内。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.clamp9+](#clamp9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | value | [ScopeType](#scopetype8) | 是 | 传入的给定值。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | [ScopeType](#scopetype8) | 如果传入的value小于下限，则返回lowerObj；如果大于上限值则返回upperObj；如果在当前范围内，则返回value。 | **示例：** ```js let tempLower = new Temperature(30); let tempUpper = new Temperature(40); let tempMiDF = new Temperature(35); let range = new util.Scope(tempLower, tempUpper); let result = range.clamp(tempMiDF); ``` ## Base64(deprecated) > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[Base64Helper9+](#base64helper9)替代。 ### constructor(deprecated) constructor() Base64的构造函数。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[Base64Helper.constructor9+](#constructor9-5)替代。 **系统能力：** SystemCapability.Utils.Lang **示例：** ```js let base64 = new util.Base64(); ``` ### encodeSync(deprecated) encodeSync(src: Uint8Array): Uint8Array 通过输入参数编码后输出对应文本。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[Base64Helper.encodeSync9+](#encodesync9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | src | Uint8Array | 是 | 编码输入Uint8数组。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Uint8Array | 返回编码后新分配的Uint8数组。 | **示例：** ```js let that = new util.Base64(); let array = new Uint8Array([115,49,51]); let result = that.encodeSync(array); ``` ### encodeToStringSync(deprecated) encodeToStringSync(src: Uint8Array): string 通过输入参数编码后输出对应文本。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[Base64Helper.encodeToStringSync9+](#encodetostringsync9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | src | Uint8Array | 是 | 编码输入Uint8数组。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | string | 返回编码后的字符串。 | **示例：** ```js let that = new util.Base64(); let array = new Uint8Array([115,49,51]); let result = that.encodeToStringSync(array); ``` ### decodeSync(deprecated) decodeSync(src: Uint8Array | string): Uint8Array 通过输入参数解码后输出对应文本。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[Base64Helper.decodeSync9+](#decodesync9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | src | Uint8Array \| string | 是 | 解码输入Uint8数组或者字符串。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Uint8Array | 返回解码后新分配的Uint8数组。 | **示例：** ```js let that = new util.Base64(); let buff = 'czEz'; let result = that.decodeSync(buff); ``` ### encode(deprecated) encode(src: Uint8Array): Promise<Uint8Array> 通过输入参数异步编码后输出对应文本。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[Base64Helper.encode9+](#encode9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | src | Uint8Array | 是 | 异步编码输入Uint8数组。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Promise<Uint8Array> | 返回异步编码后新分配的Uint8数组。 | **示例：** ```js let that = new util.Base64(); let array = new Uint8Array([115,49,51]); let rarray = new Uint8Array([99,122,69,122]); that.encode(array).then(val=>{ for (var i = 0; i < rarray.length; i++) { console.log(val[i].toString()) } }) ``` ### encodeToString(deprecated) encodeToString(src: Uint8Array): Promise<string> 通过输入参数异步编码后输出对应文本。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[Base64Helper.encodeToString9+](#encodetostring9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | src | Uint8Array | 是 | 异步编码输入Uint8数组。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Promise<string> | 返回异步编码后的字符串。 | **示例：** ```js let that = new util.Base64(); let array = new Uint8Array([115,49,51]); that.encodeToString(array).then(val=>{ console.log(val) }) ``` ### decode(deprecated) decode(src: Uint8Array | string): Promise<Uint8Array> 通过输入参数异步解码后输出对应文本。 > **说明：** > > 从API version 8开始支持，从API version 9开始废弃，建议使用[Base64Helper.decode9+](#decode9)替代。 **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | src | Uint8Array \| string | 是 | 异步解码输入Uint8数组或者字符串。 | **返回值：** | 类型 | 说明 | | -------- | -------- | | Promise<Uint8Array> | 返回异步解码后新分配的Uint8数组。 | **示例：** ```js let that = new util.Base64(); let array = new Uint8Array([99,122,69,122]); let rarray = new Uint8Array([115,49,51]); that.decode(array).then(val=>{ for (var i = 0; i < rarray.length; i++) { console.log(val[i].toString()) } }) ```