@ohos.util (util工具函数)

该模块主要提供常用的工具函数，实现字符串编解码（TextEncoder，TextDecoder）、有理数运算（RationalNumber⁸⁺）、缓冲区管理（LRUCache⁹⁺）、范围判断（ScopeHelper⁹⁺）、Base64编解码（Base64Helper⁹⁺）、内置对象类型检查（types⁸⁺、对方法进行插桩和替换（Aspect¹¹⁺）等功能。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { util } from '@kit.ArkTS';

util.format⁹⁺

format(format: string, ...args: Object[]): string

通过式样化字符串对输入的内容按特定格式输出。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
format	string	是	格式化字符串，可以包含零个或多个占位符，用于指定要插入的参数的位置和格式。
...args	Object[]	否	替换format参数中占位符的数据，此参数缺失时，默认返回第一个参数。

返回值：

类型	说明
string	格式化后的字符串。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

格式说明符：

格式说明符	说明
%s	将参数转换为字符串，用于除Object，BigInt和-0之外的所有值。
%d	将参数作为十进制整数进行格式化输出，用于除Symbol和BigInt之外的所有值。
%i	将字符串转换为十进制整数，用于除BigInt和Symbol之外的所有值。
%f	将字符串转换为浮点数，用于除BigInt和Symbol之外的所有值。
%j	将JavaScript对象转换为JSON字符串进行格式化输出。
%o	用于将JavaScript对象进行格式化输出，将对象转换为字符串表示，但不包含对象的原型链信息。
%O	用于将JavaScript对象进行格式化输出，将对象转换为字符串表示。
%c	只在浏览器环境中有效。其余环境不会产生样式效果。
%%	转义百分号的特殊格式化占位符。

示例：

import { util } from '@kit.ArkTS';

interface utilAddresstype {
  city: string;
  country: string;
}
interface utilPersontype {
  name: string;
  age: number;
  address: utilAddresstype;
}

let name = 'John';
let age = 20;
let formattedString = util.format('My name is %s and I am %s years old', name, age);
console.info(formattedString);
// 输出结果：My name is John and I am 20 years old
let num = 10.5;
formattedString = util.format('The number is %d', num);
console.info(formattedString);
// 输出结果：The number is 10.5
num = 100.5;
formattedString = util.format('The number is %i', num);
console.info(formattedString);
// 输出结果：The number is 100
const pi = 3.141592653;
formattedString = util.format('The value of pi is %f', pi);
console.info(formattedString);
// 输出结果：The value of pi is 3.141592653
const obj: Record<string,number | string> = { "name": 'John', "age": 20 };
formattedString = util.format('The object is %j', obj);
console.info(formattedString);
// 输出结果：The object is {"name":"John","age":20}
const person: utilPersontype = {
  name: 'John',
  age: 20,
  address: {
    city: 'New York',
    country: 'USA'
  }
};
console.info(util.format('Formatted object using %%O: %O', person));
console.info(util.format('Formatted object using %%o: %o', person));
/*
输出结果：
Formatted object using %O: { name: 'John',
  age: 20,
  address:
  { city: 'New York',
    country: 'USA' } }
Formatted object using %o: { name: 'John',
  age: 20,
  address:
  { city: 'New York',
    country: 'USA' } }
*/
const percentage = 80;
let arg = 'homework';
formattedString = util.format('John finished %d%% of the %s', percentage, arg);
console.info(formattedString);
// 输出结果：John finished 80% of the homework

util.errnoToString⁹⁺

errnoToString(errno: number): string

获取系统错误码对应的详细信息。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
errno	number	是	系统发生错误产生的错误码。

返回值：

类型	说明
string	错误码对应的详细信息。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let errnum = -1; // -1 : a system error number
let result = util.errnoToString(errnum);
console.info("result = " + result);
// 输出结果：result = operation not permitted

部分错误码及信息示例：

错误码	信息
-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），第二个参数将是已解决的值。

说明：

该接口要求参数original必须是异步函数类型。如果传入的参数不是异步函数，不会进行拦截，但是会输出错误信息："callbackWrapper: The type of Parameter must be AsyncFunction"。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
original	Function	是	异步函数。

返回值：

类型	说明
Function	返回一个回调函数，该函数第一个参数err是拒绝原因（如果 Promise 已解决，则为 null），第二个参数value是已解决的值。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

async function fn() {
  return 'hello world';
}
let cb = util.callbackWrapper(fn);
cb(1, (err : Object, ret : string) => {
  if (err) throw new Error;
  console.info(ret);
});
// 输出结果：hello world

util.promisify⁹⁺

promisify(original: (err: Object, value: Object) => void): Function

对异步函数处理并返回一个promise的函数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
original	Function	是	回调函数中第一个参数err是拒绝原因（如果 Promise 已解决，则为 null），第二个参数value是已解决的值。

返回值：

类型	说明
Function	返回一个 Promise 的函数。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

async function fn() {
  return 'hello world';
}
const addCall = util.promisify(util.callbackWrapper(fn));
(async () => {
  try {
    let res: string = await addCall();
    console.info(res);
    // 输出结果：hello world
  } catch (err) {
    console.info(err);
  }
})();

util.generateRandomUUID⁹⁺

generateRandomUUID(entropyCache?: boolean): string

使用加密安全随机数生成器生成随机的RFC 4122版本4的string类型UUID。为了提升性能，此接口会默认使用缓存，即入参为true，最多可缓存128个随机的UUID。当缓存中128个UUID都被使用后，会重新进行一次缓存UUID的生成，以保证UUID的随机性。假如不需要使用缓存的UUID，请将入参设置为false。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
entropyCache	boolean	否	是否使用已缓存的UUID。true表示使用缓存的UUID，false表示不使用缓存的UUID。默认值为true。

返回值：

类型	说明
string	表示此UUID的字符串。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Incorrect parameter types.

示例：

let uuid = util.generateRandomUUID(true);
console.info("RFC 4122 Version 4 UUID:" + uuid);
// 输出随机生成的UUID

util.generateRandomBinaryUUID⁹⁺

generateRandomBinaryUUID(entropyCache?: boolean): Uint8Array

使用加密安全随机数生成器生成随机的RFC 4122版本4的Uint8Array类型UUID。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
entropyCache	boolean	否	是否使用已缓存的UUID。true表示使用缓存的UUID，false表示不使用缓存的UUID。默认值为true。

返回值：

类型	说明
Uint8Array	表示此UUID的Uint8Array值。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Incorrect parameter types.

示例：

let uuid = util.generateRandomBinaryUUID(true);
console.info(JSON.stringify(uuid));
// 输出随机生成的UUID

util.parseUUID⁹⁺

parseUUID(uuid: string): Uint8Array

将generateRandomUUID生成的string类型UUID转换为generateRandomBinaryUUID生成的Uint8Array类型UUID，如RFC 4122版本4中所述。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
uuid	string	是	UUID字符串。

返回值：

类型	说明
Uint8Array	返回表示此UUID的Uint8Array，如果解析失败，则抛出SyntaxError。

错误码：

以下错误码的详细介绍请参见通用错误码和语言基础类库错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Incorrect parameter types.
10200002	Invalid uuid string.

示例：

let uuid = util.parseUUID("84bdf796-66cc-4655-9b89-d6218d100f9c");
console.info("uuid = " + uuid);
// 输出结果：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.format⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
format	string	是	式样化字符串。
...args	Object[]	否	替换式样化字符串通配符的数据，此参数缺失时，默认返回第一个参数。

返回值：

类型	说明
string	按特定格式式样化后的字符串。

示例：

let res = util.printf("%s", "hello world!");
console.info(res);
// 输出结果：hello world!

util.getErrorString^(deprecated)

getErrorString(errno: number): string

获取系统错误码对应的详细信息。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用util.errnoToString⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
errno	number	是	系统发生错误产生的错误码。

返回值：

类型	说明
string	错误码对应的详细信息。

示例：

let errnum = -1; // -1 : a system error number
let result = util.getErrorString(errnum);
console.info("result = " + result);
// 输出结果：result = operation not permitted

util.promiseWrapper^(deprecated)

promiseWrapper(original: (err: Object, value: Object) => void): Object

对异步函数处理并返回一个promise的版本。

说明：

此接口不可用，建议使用util.promisify⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
original	Function	是	异步函数。

返回值：

类型	说明
Function	采用遵循常见的错误优先的回调风格的函数（也就是将 (err, value) => ... 回调作为最后一个参数），并返回一个返回 promise 的版本。

util.getHash¹²⁺

getHash(object: object): number

获取对象的Hash值。如果是第一次获取，则计算Hash值并保存到对象的Hash域（返回随机的Hash值）；如果不是第一次获取，则从Hash域中获取并返回Hash值（同一对象多次返回值保持不变）。

原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
object	object	是	希望获取Hash值的对象。

返回值：

类型	说明
number	Hash值。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

interface Person {
  name: string,
  age: number
}
let obj: Person = { name: 'Jack', age: 20 };
let result1 = util.getHash(obj);
console.info('result1 is ' + result1);
let result2 = util.getHash(obj);
console.info('result2 is ' + result2);
// 输出结果：result1 与 result2 的值相等，且为随机的Hash值。

TextDecoderOptions¹¹⁺

解码相关选项参数，存在两个属性fatal和ignoreBOM。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

名称	类型	必填	说明
fatal	boolean	否	是否显示致命错误。true表示显示致命错误，false表示不显示致命错误。默认值是false。
ignoreBOM	boolean	否	是否忽略BOM标记，true表示忽略待解码数据的BOM标记，false表示不忽略待解码数据的BOM标记并对其进行解码，默认值是false。

DecodeToStringOptions¹²⁺

解码是否使用流处理方式。

原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

名称	类型	必填	说明
stream	boolean	否	输入末尾出现的不完整字节序列是否需要追加在下次调用decodeToString的参数中处理。设置为true，则不完整的字节序列会存储在内部缓存区直到下次调用该函数，false则会在当前调用时直接解码。默认为false。

DecodeWithStreamOptions¹¹⁺

解码是否跟随附加数据块相关选项参数。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

名称	类型	必填	说明
stream	boolean	否	在随后的decodeWithStream()调用中是否跟随附加数据块。如果以块的形式处理数据，则设置为true；如果处理最后的数据块或数据未分块，则设置为false。默认为false。

Aspect¹¹⁺

Aspect类用于封装提供切面能力（Aspect Oriented Programming，简写AOP）的接口，这些接口可以用来对类方法进行前后插桩或者替换实现。

addBefore¹¹⁺

static addBefore(targetClass: Object, methodName: string, isStatic: boolean, before: Function): void

在指定的类对象的原方法执行前插入一个函数。addBefore接口执行完成后，都会先执行插入的函数逻辑，再执行指定类对象的原方法。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
targetClass	Object	是	指定的类对象。
methodName	string	是	指定的方法名，不支持read-only方法。
isStatic	boolean	是	指定的原方法是否为静态方法。true表示静态方法，false表示实例方法。
before	Function	是	要插入的函数对象。函数有参数，则第一个参数是this对象（若isStatic为true，则为类对象即targetClass；若isStatic为false，则为调用方法的实例对象），其余参数是原方法的参数。函数也可以无参数，无参时不做处理。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class MyClass {
  msg: string = 'msg000';
  foo(arg: string): string {
    console.info('foo arg is ' + arg);
    return this.msg;
  }

  static data: string = 'data000';
  static bar(arg: string): string {
    console.info('bar arg is ' + arg);
	return MyClass.data;
  }
}

let asp = new MyClass();
let result = asp.foo('123');
// 输出结果：foo arg is 123
console.info('result is ' + result);
// 输出结果：result is msg000
console.info('asp.msg is ' + asp.msg);
// 输出结果：asp.msg is msg000

util.Aspect.addBefore(MyClass, 'foo', false, (instance: MyClass, arg: string) => {
  console.info('arg is ' + arg);
  instance.msg = 'msg111';
  console.info('msg is changed to ' + instance.msg)
});

result = asp.foo('123');
// 输出结果：arg is 123
// 输出结果：msg is changed to msg111
// 输出结果：foo arg is 123
console.info('result is ' + result);
// 输出结果：result is msg111
console.info('asp.msg is ' + asp.msg);
// 输出结果：asp.msg is msg111


let res = MyClass.bar('456');
// 输出结果：bar arg is 456
console.info('res is ' + res);
// 输出结果：res is data000
console.info('MyClass.data is ' + MyClass.data);
// 输出结果：MyClass.data is data000

util.Aspect.addBefore(MyClass, 'bar', true, (target: Object, arg: string) => {
  console.info('arg is ' + arg);
  let newVal = 'data111';
  Reflect.set(target, 'data', newVal);
  console.info('data is changed to ' + newVal);
});

res = MyClass.bar('456');
// 输出结果：arg is 456
// 输出结果：data is changed to data111
// 输出结果：bar arg is 456
console.info('res is ' + res);
// 输出结果：res is data111
console.info('MyClass.data is ' + MyClass.data);
// 输出结果：MyClass.data is data111

addAfter¹¹⁺

static addAfter(targetClass: Object, methodName: string, isStatic: boolean, after: Function): void

在指定的类方法执行后插入一段逻辑。最终返回值是插入函数执行后的返回值。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
targetClass	Object	是	指定的类对象。
methodName	string	是	指定的原方法名，不支持read-only方法。
isStatic	boolean	是	指定的原方法是否为静态方法。true表示静态方法，false表示实例方法。
after	Function	是	要插入的函数。函数有参数时，则第一个参数是this对象（若isStatic为true，则为类对象即targetClass；若isStatic为false，则为调用方法的实例对象），第二个参数是原方法的返回值（如果原方法没有返回值，则为undefined），其余参数是原方法的参数。函数也可以无参，无参时不做处理。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class MyClass {
  msg: string = 'msg000';
  foo(arg: string): string {
    console.info('foo arg is ' + arg);
    return this.msg;
  }
}

let asp = new MyClass();
let result = asp.foo('123');
// 输出结果：foo arg is 123
console.info('result is ' + result);
// 输出结果：result is msg000
console.info('asp.msg is ' + asp.msg);
// 输出结果：asp.msg is msg000

util.Aspect.addAfter(MyClass, 'foo', false, (instance: MyClass, ret: string, arg: string): string => {
  console.info('arg is ' + arg);
  console.info('ret is ' + ret);
  instance.msg = 'msg111';
  console.info('msg is changed to ' + instance.msg);
  return 'msg222';
});

result = asp.foo('123');
// 输出结果：foo arg is 123
// 输出结果：arg is 123
// 输出结果：ret is msg000
// 输出结果：msg is changed to msg111
console.info('result is ' + result);
// 输出结果：result is msg222
console.info('asp.msg is ' + asp.msg);
// 输出结果：asp.msg is msg111

// 前后插桩的例子
class AroundTest {
  foo(arg: string) {
    console.info('execute foo with arg ' + arg);
  }
}
util.Aspect.addBefore(AroundTest, 'foo', false, () => {
  console.info('execute before');
});
util.Aspect.addAfter(AroundTest, 'foo', false, () => {
  console.info('execute after');
});

(new AroundTest()).foo('hello');
// 输出结果：execute before
// 输出结果：execute foo with arg hello
// 输出结果：execute after

replace¹¹⁺

static replace(targetClass: Object, methodName: string, isStatic: boolean, instead: Function) : void

将指定的类方法的原方法替换为另一个函数。replace接口执行完成后，调用指定的类方法时，只会执行替换后的逻辑。最终返回值为替换函数执行完毕的返回值。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
targetClass	Object	是	指定的类对象。
methodName	string	是	指定的原方法名，不支持read-only方法。
isStatic	boolean	是	指定的原方法是否为静态方法。true表示静态方法，false表示实例方法。
instead	Function	是	要用来替换原方法的函数。函数有参数时，则第一个参数是this对象（若isStatic为true，则为类对象即targetClass；若isStatic为false，则为调用方法的实例对象），其余参数是原方法的参数。函数也可以无参，无参时不做处理。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class MyClass {
  msg: string = 'msg000';
  foo(arg: string): string {
    console.info('foo arg is ' + arg);
    return this.msg;
  }
}

let asp = new MyClass();
let result = asp.foo('123');
// 输出结果：foo arg is 123
console.info('result is ' + result);
// 输出结果：result is msg000
console.info('asp.msg is ' + asp.msg);
// 输出结果：asp.msg is msg000

util.Aspect.replace(MyClass, 'foo', false, (instance: MyClass, arg: string): string => {
  console.info('execute instead')
  console.info('arg is ' + arg);
  instance.msg = 'msg111';
  console.info('msg is changed to ' + instance.msg);
  return 'msg222';
});

result = asp.foo('123');
// 输出结果：execute instead
// 输出结果：arg is 123
// 输出结果：msg is changed to msg111
console.info('result is ' + result);
// 输出结果：result is msg222
console.info('asp.msg is ' + asp.msg);
// 输出结果：asp.msg is msg111

TextDecoder

TextDecoder用于将字节数组解码为字符串，可以处理多种编码格式，包括utf-8、utf-16le/be、iso-8859和windows-1251等不同的编码格式。

属性

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： 以下各项对应的系统能力均为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-cyrillic、gbk、gb18030、big5、euc-jp、iso-2022-jp、shift_jis、euc-kr、utf-16be、utf-16le、UTF-8、GBK、GB2312、gb2312、GB18030、iso-8859-1。
fatal	boolean	是	否	是否显示致命错误。true表示显示致命错误，false表示不显示致命错误。
ignoreBOM	boolean	是	否	是否忽略BOM（byte order marker）标记，默认值为false ，表示解码结果包含BOM标记。

constructor⁹⁺

constructor()

TextDecoder的构造函数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

示例：

let textDecoder = new util.TextDecoder();
let retStr = textDecoder.encoding;
console.info('retStr = ' + retStr);
// 输出结果：retStr = utf-8

create⁹⁺

static create(encoding?: string, options?: TextDecoderOptions): TextDecoder

替代有参构造功能。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
encoding	string	否	编码格式，默认值是'utf-8'。
options	TextDecoderOptions	否	解码相关选项参数，存在两个属性fatal和ignoreBOM。

ArkTS1.1版本错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Incorrect parameter types.

ArkTS1.2版本错误码：

此接口在ArkTS1.2无错误码。

示例：

let textDecoderOptions: util.TextDecoderOptions = {
  fatal: false,
  ignoreBOM : true
}
let textDecoder = util.TextDecoder.create('utf-8', textDecoderOptions);
let retStr = textDecoder.encoding;
console.info('retStr = ' + retStr);
// 输出结果：retStr = utf-8

decodeToString¹²⁺

decodeToString(input: Uint8Array, options?: DecodeToStringOptions): string

通过输入参数解码后输出对应文本。

原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
input	Uint8Array	是	符合格式需要解码的数组。
options	DecodeToStringOptions	否	解码相关选项参数。默认undefined。

返回值：

类型	说明
string	解码后的数据。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let textDecoderOptions: util.TextDecoderOptions = {
  fatal: false,
  ignoreBOM : true
}
let decodeToStringOptions: util.DecodeToStringOptions = {
  stream: false
}
let textDecoder = util.TextDecoder.create('utf-8', textDecoderOptions);
let uint8 = new Uint8Array([0xEF, 0xBB, 0xBF, 0x61, 0x62, 0x63]);
let retStr = textDecoder.decodeToString(uint8, decodeToStringOptions);
console.info("retStr = " + retStr);
// 输出结果：retStr = abc

decodeWithStream^(deprecated)

decodeWithStream(input: Uint8Array, options?: DecodeWithStreamOptions): string

通过输入参数解码后输出对应文本。当input是一个空数组时，返回值为undefined。

说明：

从API version 9开始支持，从API version 12开始废弃，建议使用decodeToString¹²⁺替代。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
input	Uint8Array	是	符合格式需要解码的数组。
options	DecodeWithStreamOptions	否	解码相关选项参数。

返回值：

类型	说明
string	解码后的数据。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let textDecoderOptions: util.TextDecoderOptions = {
  fatal: false,
  ignoreBOM : true
}
let decodeWithStreamOptions: util.DecodeWithStreamOptions = {
  stream: false
}
let textDecoder = util.TextDecoder.create('utf-8', textDecoderOptions);
let uint8 = new Uint8Array(6);
uint8[0] = 0xEF;
uint8[1] = 0xBB;
uint8[2] = 0xBF;
uint8[3] = 0x61;
uint8[4] = 0x62;
uint8[5] = 0x63;
console.info("input num:");
let retStr = textDecoder.decodeWithStream(uint8, decodeWithStreamOptions);
console.info("retStr = " + retStr);
// 输出结果：retStr = abc

constructor^(deprecated)

constructor(encoding?: string, options?: { fatal?: boolean; ignoreBOM?: boolean })

TextDecoder的构造函数。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用create⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
encoding	string	否	编码格式，默认值是'utf-8'。
options	object	否	解码相关选项参数，存在两个属性fatal和ignoreBOM。

表1 options

名称	参数类型	必填	说明
fatal	boolean	否	是否显示致命错误。true表示显示致命错误，false表示不显示致命错误。默认值是false。
ignoreBOM	boolean	否	是否忽略BOM标记。true表示忽略待解码数据的BOM标记，false表示不忽略待解码数据的BOM标记并对其进行解码。默认值是false。

示例：

let textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true});

decode^(deprecated)

decode(input: Uint8Array, options?: { stream?: false }): string

通过输入参数解码后输出对应文本。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用decodeToString¹²⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
input	Uint8Array	是	符合格式需要解码的数组。
options	object	否	解码相关选项参数。

表2 options

名称	参数类型	必填	说明
stream	boolean	否	在随后的decode()调用中是否跟随附加数据块。如果以块的形式处理数据，则设置为true；如果处理最后的数据块或数据未分块，则设置为false。默认为false。

返回值：

类型	说明
string	解码后的数据。

示例：

let textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true});
let uint8 = new Uint8Array(6);
uint8[0] = 0xEF;
uint8[1] = 0xBB;
uint8[2] = 0xBF;
uint8[3] = 0x61;
uint8[4] = 0x62;
uint8[5] = 0x63;
console.info("input num:");
let retStr = textDecoder.decode(uint8, {stream: false});
console.info("retStr = " + retStr);
// 输出结果：retStr = abc

EncodeIntoUint8ArrayInfo¹¹⁺

编码后的文本，类型为number。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

名称	类型	只读	可选	说明
read	number	是	否	表示已读取的字符数。
written	number	是	否	表示已写入的字节数。

EncodeIntoUint8ArrayInfo²⁰⁺

编码后的文本，类型为int。

原子化服务API：从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

名称	类型	只读	可选	说明
read	int	是	否	表示已读取的字符数。
written	int	是	否	表示已写入的字节数。

TextEncoder

TextEncoder用于将字符串编码为字节数组，支持多种编码格式。 需要注意的是，在使用TextEncoder进行编码时，不同编码格式下字符所占的字节数是不同的，在使用TextEncoder时需要明确指定要使用的编码格式，以确保编码结果正确。

属性

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： 以下各项对应的系统能力均为SystemCapability.Utils.Lang。

名称	类型	只读	可选	说明
encoding	string	是	否	编码格式。 - 支持格式：utf-8、UTF-8、GBK、GB2312、gb2312、GB18030、gb18030、ibm866、iso-8859-1、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、gbk、big5、euc-jp、iso-2022-jp、shift_jis、euc-kr、x-mac-cyrillic、utf-16be、utf-16le。 -  默认值是：'utf-8'。

constructor

constructor()

TextEncoder的构造函数。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

示例：

let textEncoder = new util.TextEncoder();

constructor⁹⁺

constructor(encoding?: string)

TextEncoder的构造函数。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
encoding	string	否	编码格式，默认值为'utf-8'。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Incorrect parameter types.

示例：

let textEncoder = new util.TextEncoder("utf-8");

create¹²⁺

static create(encoding?: string): TextEncoder

创建TextEncoder对象的方法。

原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
encoding	string	否	编码格式，默认值为'utf-8'。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Incorrect parameter types.

示例：

let textEncoder = util.TextEncoder.create("utf-8");

encodeInto⁹⁺

encodeInto(input?: string): Uint8Array

通过输入参数编码后输出Uint8Array对象。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
input	string	否	需要编码的字符串，默认值是空字符串。当入参是空字符串时，返回值是undefined。

返回值：

类型	说明
Uint8Array	返回编码后的Uint8Array对象。

ArkTS1.1版本错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Incorrect parameter types.

ArkTS1.2版本错误码：

此接口在ArkTS1.2无错误码。

示例：

let textEncoder = new util.TextEncoder();
let result = textEncoder.encodeInto("\uD800¥¥");
console.info("result = " + result);
// 输出结果: result = 237,160,128,194,165,194,165

encodeIntoUint8Array⁹⁺

encodeIntoUint8Array(input: string, dest: Uint8Array): EncodeIntoUint8ArrayInfo

对字符串进行编码，将结果写入dest数组。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
input	string	是	需要编码的字符串。
dest	Uint8Array	是	Uint8Array对象实例，用于将生成的UTF-8编码文本放入其中。

返回值：

类型	说明
EncodeIntoUint8ArrayInfo	返回一个对象，read表示已编码的字符数，write表示编码字符所占用的字节数。

ArkTS1.1版本错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

ArkTS1.2版本错误码：

此接口在ArkTS1.2无错误码。

示例：

let textEncoder = new util.TextEncoder();
let buffer = new ArrayBuffer(4);
let uint8 = new Uint8Array(buffer);
let result = textEncoder.encodeIntoUint8Array('abcd', uint8);
console.info("uint8 = " + uint8);
// 输出结果: uint8 = 97,98,99,100
console.info("result.read = " + result.read);
// 输出结果: result.read = 4
console.info("result.written = " + result.written);
// 输出结果: result.written = 4

encodeInto^(deprecated)

encodeInto(input: string, dest: Uint8Array): { read: number; written: number }

放置生成的UTF-8编码文本。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用encodeIntoUint8Array⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
input	string	是	需要编码的字符串。
dest	Uint8Array	是	Uint8Array对象实例，用于将生成的UTF-8编码文本放入其中。

返回值：

类型	说明
Uint8Array	返回编码后的文本。

示例：

let textEncoder = new util.TextEncoder();
let buffer = new ArrayBuffer(4);
let uint8 = new Uint8Array(buffer);
let result = textEncoder.encodeInto('abcd', uint8);
console.info("uint8 = " + uint8);
// 输出结果: uint8 = 97,98,99,100

encode^(deprecated)

encode(input?: string): Uint8Array

通过输入参数编码后输出对应文本。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用encodeInto⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
input	string	否	需要编码的字符串，默认值是空字符串。

返回值：

类型	说明
Uint8Array	返回编码后的文本。

示例：

let textEncoder = new util.TextEncoder();
let result = textEncoder.encode("\uD800¥¥");
console.info("result = " + result);
// 输出结果: result = 237,160,128,194,165,194,165

RationalNumber⁸⁺

RationalNumber主要是对有理数进行比较，获取分子分母等方法。例如使用toString()方法可以将有理数转换为字符串形式，使用该类可以方便地进行有理数的各种操作。

constructor⁹⁺

constructor()

RationalNumber的构造函数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

示例：

let rationalNumber = new util.RationalNumber();

parseRationalNumber⁹⁺

static parseRationalNumber(numerator: number,denominator: number): RationalNumber

用于创建具有给定分子和分母的RationalNumber实例。

说明：

该接口要求参数numerator和denominator必须是整数类型。如果传入的参数是小数类型，不会进行拦截，但是会输出错误信息："parseRationalNumber: The type of Parameter must be integer"。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
numerator	number	是	分子，整数类型。取值范围：-Number.MAX_VALUE <= numerator <= Number.MAX_VALUE。
denominator	number	是	分母，整数类型。取值范围：-Number.MAX_VALUE <= denominator <= Number.MAX_VALUE。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);

createRationalFromString⁸⁺

static createRationalFromString(rationalString: string): RationalNumber​

基于给定的字符串创建一个RationalNumber对象。

说明：

该接口要求参数rationalString是字符串格式。如果传入的参数是小数类型字符串格式，不会进行拦截，但是会输出错误信息："createRationalFromString: The type of Parameter must be integer string"。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
rationalString	string	是	字符串格式。

返回值：

类型	说明
Object	返回RationalNumber对象。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	The type of rationalString must be string.

示例：

let rational = util.RationalNumber.createRationalFromString("3/4");

compare⁹⁺

compare(another: RationalNumber): number​

将当前RationalNumber对象与目标RationalNumber对象进行比较，并返回比较结果。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
another	RationalNumber	是	其他的有理数对象。

返回值：

类型	说明
number	如果两个对象相等，则返回0；如果给定对象小于当前对象，则返回1；如果给定对象大于当前对象，则返回-1。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);
let rational = util.RationalNumber.createRationalFromString("3/4");
let result = rationalNumber.compare(rational);
console.info("result = " + result);
// 输出结果：result = -1

valueOf⁸⁺

valueOf(): number

以整数形式或者浮点数的形式获取当前RationalNumber对象的值。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回整数或者浮点数的值。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = rationalNumber.valueOf();
console.info("result = " + result);
// 输出结果：result = 0.5

API 9及以上建议使用以下写法：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);
let result = rationalNumber.valueOf();
console.info("result = " + result);
// 输出结果：result = 0.5

equals⁸⁺

equals(obj: Object): boolean

将当前的RationalNumber对象与给定的对象进行比较是否相等。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
obj	Object	是	其他类型对象。

返回值：

类型	说明
boolean	如果给定对象与当前对象相同，则返回true；否则返回false。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let rational = util.RationalNumber.createRationalFromString("3/4");
let result = rationalNumber.equals(rational);
console.info("result = " + result);
// 输出结果：result = false

API 9及以上建议使用以下写法：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);
let rational = util.RationalNumber.createRationalFromString("3/4");
let result = rationalNumber.equals(rational);
console.info("result = " + result);
// 输出结果：result = false

getCommonFactor⁹⁺

static getCommonFactor(number1: number,number2: number): number

获取两个指定整数的最大公约数。

说明：

该接口要求参数number1和number2必须是整数类型。如果传入的参数是小数类型，不会进行拦截，但是会输出错误信息："getCommonFactor: The type of Parameter must be integer"。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
number1	number	是	整数类型。-Number.MAX_VALUE <= number1 <= Number.MAX_VALUE。
number2	number	是	整数类型。-Number.MAX_VALUE <= number2 <= Number.MAX_VALUE。

返回值：

类型	说明
number	返回两个给定数字的最大公约数。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let result = util.RationalNumber.getCommonFactor(4,6);
console.info("result = " + result);
// 输出结果：result = 2

getNumerator⁸⁺

getNumerator(): number

获取当前RationalNumber对象的分子。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回RationalNumber对象的分子的值。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = rationalNumber.getNumerator();
console.info("result = " + result);
// 输出结果：result = 1

API 9及以上建议使用以下写法：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);
let result = rationalNumber.getNumerator();
console.info("result = " + result);
// 输出结果：result = 1

getDenominator⁸⁺

getDenominator(): number

获取当前RationalNumber对象的分母。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回RationalNumber对象的分母的值。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = rationalNumber.getDenominator();
console.info("result = " + result);
// 输出结果：result = 2

API 9及以上建议使用以下写法：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2)
let result = rationalNumber.getDenominator();
console.info("result = " + result);
// 输出结果：result = 2

isZero⁸⁺

isZero():boolean

检查当前RationalNumber对象是否为0。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
boolean	如果当前对象表示的值为0，则返回true；否则返回false。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = rationalNumber.isZero();
console.info("result = " + result);
// 输出结果：result = false

API 9及以上建议使用以下写法：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);
let result = rationalNumber.isZero();
console.info("result = " + result);
// 输出结果：result = false

isNaN⁸⁺

isNaN(): boolean

检查当前RationalNumber对象是否表示非数字(NaN)值。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
boolean	如果分母和分子都为0，则返回true；否则返回false。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = rationalNumber.isNaN();
console.info("result = " + result);
// 输出结果：result = false

API 9及以上建议使用以下写法：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);
let result = rationalNumber.isNaN();
console.info("result = " + result);
// 输出结果：result = false

isFinite⁸⁺

isFinite():boolean

检查当前RationalNumber对象是否表示一个有限值。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
boolean	如果分母不为0，则返回true；否则返回false。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = rationalNumber.isFinite();
console.info("result = " + result);
// 输出结果：result = true

API 9及以上建议使用以下写法：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);
let result = rationalNumber.isFinite();
console.info("result = " + result);
// 输出结果：result = true

toString⁸⁺

toString(): string

获取当前RationalNumber对象的字符串表示形式。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
string	返回Numerator/Denominator格式的字符串，例如3/5，如果当前对象的分子为0，则返回0/1。如果当前对象的分母为0，则返回Infinity。如果当前对象的分子和分母都为0，则返回NaN。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = rationalNumber.toString();
console.info("result = " + result);
// 输出结果：result = 1/2

API 9及以上建议使用以下写法：

let rationalNumber = util.RationalNumber.parseRationalNumber(1,2);
let result = rationalNumber.toString();
console.info("result = " + result);
// 输出结果：result = 1/2

constructor^(deprecated)

constructor(numerator: number,denominator: number)

RationalNumber的构造函数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用parseRationalNumber⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
numerator	number	是	分子，整数类型。
denominator	number	是	分母，整数类型。

示例：

let rationalNumber = new util.RationalNumber(1,2);

compareTo^(deprecated)

compareTo(another: RationalNumber): number​

将当前的RationalNumber对象与给定的对象进行比较。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用compare⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
another	RationalNumber	是	其他的有理数对象。

返回值：

类型	说明
number	如果两个对象相等，则返回0；如果给定对象小于当前对象，则返回1；如果给定对象大于当前对象，则返回-1。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let rational = util.RationalNumber.createRationalFromString("3/4");
let result = rationalNumber.compareTo(rational);
console.info("result = " + result);
// 输出结果：result = -1

getCommonDivisor^(deprecated)

static getCommonDivisor(number1: number,number2: number): number

获取两个指定整数的最大公约数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用getCommonFactor⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
number1	number	是	整数类型。
number2	number	是	整数类型。

返回值：

类型	说明
number	返回两个给定数字的最大公约数。

LRUCache⁹⁺

LRUCache用于在缓存空间不够的时候，将近期最少使用的数据替换为新数据。此设计基于资源访问的考虑：近期访问的数据，可能在不久的将来会再次访问。于是最少访问的数据就是价值最小的数据，是最应该踢出缓存空间的数据。

属性

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： 以下各项对应的系统能力均为SystemCapability.Utils.Lang。

名称	类型	可读	可写	说明
length	number	是	否	当前缓冲区中值的总数。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.put(1, 8);
let result = pro.length;
console.info('result = ' + result);
// 输出结果：result = 2

constructor⁹⁺

constructor(capacity?: number)

默认构造函数用于创建一个新的LRUCache实例，默认容量为64。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
capacity	number	否	指示要为缓冲区自定义的容量，不传默认值为64，最大值不能超过2147483647。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1.Incorrect parameter types.

示例：

let pro = new util.LRUCache<number, number>();

updateCapacity⁹⁺

updateCapacity(newCapacity: number): void

将缓冲区容量更新为指定容量，如果newCapacity小于或等于0，则抛出异常。当缓冲区中值的总数大于指定容量时，会执行删除操作。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
newCapacity	number	是	指示要为缓冲区自定义的容量，最大值不能超过2147483647。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.

示例：

let pro = new util.LRUCache<number, number>();
pro.updateCapacity(100);

toString⁹⁺

toString(): string

返回对象的字符串表示形式。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
string	返回对象的字符串表示形式。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.get(2);
pro.get(3);
console.info(pro.toString());
// 输出结果：LRUCache[ maxSize = 64, hits = 1, misses = 1, hitRate = 50% ]
// maxSize: 缓存区最大值 hits: 查询值匹配成功的次数 misses: 查询值匹配失败的次数 hitRate: 查询值匹配率

getCapacity⁹⁺

getCapacity(): number

获取当前缓冲区的容量。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回当前缓冲区的容量。

示例：

let pro = new util.LRUCache<number, number>();
let result = pro.getCapacity();
console.info('result = ' + result);
// 输出结果：result = 64

clear⁹⁺

clear(): void

从当前缓冲区清除键值对。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
let result = pro.length;
pro.clear();
let res = pro.length;
console.info('result = ' + result);
console.info('res = ' + res);
// 输出结果：result = 1
// 输出结果：res = 0

getCreateCount⁹⁺

getCreateCount(): number

获取创建对象的次数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回创建对象的次数。

示例：

// 创建新类ChildLRUCache继承LRUCache，重写createDefault方法，返回一个非undefined的值。
class ChildLRUCache extends util.LRUCache<number, number> {
  constructor() {
    super();
  }

  createDefault(key: number): number {
    return key;
  }
}
let lru = new ChildLRUCache();
lru.put(2, 10);
lru.get(3);
lru.get(5);
let res = lru.getCreateCount();
console.info('res = ' + res);
// 输出结果：res = 2

getMissCount⁹⁺

getMissCount(): number

获取查询值不匹配的次数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回查询值不匹配的次数。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.get(2);
let result = pro.getMissCount();
console.info('result = ' + result);
// 输出结果：result = 0

getRemovalCount⁹⁺

getRemovalCount(): number

获取缓冲区键值对回收的次数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回缓冲区键值对回收的次数。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.updateCapacity(2);
pro.put(50, 22);
let result = pro.getRemovalCount();
console.info('result = ' + result);
// 输出结果：result = 0

getMatchCount⁹⁺

getMatchCount(): number

获取查询值匹配成功的次数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回查询值匹配成功的次数。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.get(2);
let result = pro.getMatchCount();
console.info('result = ' + result);
// 输出结果：result = 1

getPutCount⁹⁺

getPutCount(): number

获取将值添加到缓冲区的次数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
number	返回将值添加到缓冲区的次数。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
let result = pro.getPutCount();
console.info('result = ' + result);
// 输出结果：result = 1

isEmpty⁹⁺

isEmpty(): boolean

检查当前缓冲区是否为空。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
boolean	如果当前缓冲区不包含任何值，则返回true。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
let result = pro.isEmpty();
console.info('result = ' + result);
// 输出结果：result = false

get⁹⁺

get(key: K): V | undefined

返回键对应的值。当键不在缓冲区中时，通过createDefault⁹⁺接口创建，若createDefault创建的值不为undefined时，此时会调用afterRemoval⁹⁺接口，返回createDefault创建的值。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
key	K	是	要查询的键。

返回值：

类型	说明
V | undefined	如果指定的键存在于缓冲区中，则返回与键关联的值；否则返回createDefault创建的值。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
let result  = pro.get(2);
console.info('result = ' + result);
// 输出结果：result = 10

put⁹⁺

put(key: K,value: V): V

将键值对添加到缓冲区中，返回与添加的键关联的值。当缓冲区中值的总数大于容量时，会执行删除操作。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
key	K	是	要添加的键。
value	V	是	要添加的键所关联的值。

返回值：

类型	说明
V	返回与添加的键关联的值。如果键或值为空，则抛出此异常。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let pro = new util.LRUCache<number, number>();
let result = pro.put(2, 10);
console.info('result = ' + result);
// 输出结果：result = 10

put²⁰⁺

put(key: K,value: V): V | undefined

将键值对添加到缓冲区中，返回之前与添加的键关联的值。当缓冲区中值的总数大于容量时，会执行删除操作。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
key	K	是	要添加的键。
value	V	是	要添加的键所关联的值。

返回值：

类型	说明
V | undefined	返回键之前关联的值，若键为首次添加则返回undefined。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let pro = new util.LRUCache<number, number>();
let result = pro.put(2, 10);
console.info('result = ' + result);
// 输出结果：result = undefined
result = pro.put(2, 20);
console.info('result = ' + result);
// 输出结果：result = 10

values⁹⁺

values(): V[]

返回一个列表，内部按从最近访问到最近最少访问的顺序提供当前缓冲区中所有键值对中的值。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
V []	按从最近访问到最近最少访问的顺序返回当前缓冲区中所有值的列表。

示例：

let pro = new util.LRUCache<number|string,number|string>();
pro.put(2, 10);
pro.put(2, "anhu");
pro.put("afaf", "grfb");
let result = pro.values();
console.info('result = ' + result);
// 输出结果：result = anhu,grfb

values²⁰⁺

values(): Array<V>

返回一个列表，内部按从最近访问到最近最少访问的顺序提供当前缓冲区中所有键值对中的值。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

返回值：

类型	说明
Array<V>	按从最近访问到最近最少访问的顺序返回当前缓冲区中所有值的列表。

示例：

let pro = new util.LRUCache<number|string, number|string>();
pro.put(2, 10);
pro.put(2, "anhu");
pro.put("afaf", "grfb");
let result = pro.values();
console.info('result = ' + result);
// 输出结果：result = anhu,grfb

keys⁹⁺

keys(): K[]

返回一个列表，内部按从最近访问到最近最少访问的顺序提供当前缓冲区中所有键值对中的键。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
K []	按从最近访问到最近最少访问的顺序返回当前缓冲区中所有键的列表。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.put(3, 1);
let result = pro.keys();
console.info('result = ' + result);
// 输出结果：result = 2,3

keys²⁰⁺

keys(): Array<K>

返回一个列表，内部按从最近访问到最近最少访问的顺序提供当前缓冲区中所有键值对中的键。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

返回值：

类型	说明
Array<K>	按从最近访问到最近最少访问的顺序返回当前缓冲区中所有键的列表。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.put(3, 1);
let result = pro.keys();
console.info('result = ' + result);
// 输出结果：result = 2,3

remove⁹⁺

remove(key: K): V | undefined

从当前缓冲区中删除指定的键及其关联的值，返回键关联的值。如果键不存在时，则返回undefined。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
key	K	是	要删除的键值。

返回值：

类型	说明
V | undefined	返回一个包含已删除键值对的Optional对象；如果key不存在，则返回undefined，如果key为null，则抛出异常。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
let result = pro.remove(20);
console.info('result = ' + result);
// 输出结果：result = undefined

afterRemoval⁹⁺

afterRemoval(isEvict: boolean,key: K,value: V,newValue: V): void

删除值后执行后续操作，后续操作由开发者自行实现。本接口会在删除操作时被调用，如get⁹⁺、put⁹⁺、remove⁹⁺、clear⁹⁺、updateCapacity⁹⁺接口。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
isEvict	boolean	是	因容量不足而调用该方法时，参数值为true，其他情况为false。
key	K	是	表示删除的键。
value	V	是	表示删除的值。
newValue	V	是	如果已调用put方法并且要添加的键已经存在，则参数值是关联的新值。其他情况下参数值为空。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class ChildLRUCache<K, V> extends util.LRUCache<K, V> {
  constructor(capacity?: number) {
    super(capacity);
  }

  afterRemoval(isEvict: boolean, key: K, value: V, newValue: V): void {
    if (isEvict === true) {
      console.info('key = ' + key);
      // 输出结果：key = 1
      console.info('value = ' + value);
      // 输出结果：value = 1
      console.info('newValue = ' + newValue);
      // 输出结果：newValue = null
    }
  }
}
let lru = new ChildLRUCache<number, number>(2);
lru.put(1, 1);
lru.put(2, 2);
lru.put(3, 3);

contains⁹⁺

contains(key: K): boolean

检查当前缓冲区是否包含指定的键。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
key	K	是	表示要检查的键。

返回值：

类型	说明
boolean	如果缓冲区包含指定的键，则返回 true。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
let result = pro.contains(2);
console.info('result = ' + result);
// 输出结果：result = true

createDefault⁹⁺

createDefault(key: K): V

在缓冲区未匹配到键时将会执行的后续操作。参数表示未匹配的键，返回与键关联的值，默认返回undefined。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
key	K	是	表示未匹配的键。

返回值：

类型	说明
V	返回与键关联的值。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let pro = new util.LRUCache<number, number>();
let result = pro.createDefault(50);
console.info('result = ' + result);
// 输出结果：result = undefined

createDefault²⁰⁺

createDefault(key: K): V | undefined

在缓冲区未匹配到键时将会执行的后续操作。参数表示未匹配的键，返回与键关联的值，默认返回undefined。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
key	K	是	表示未匹配的键。

返回值：

类型	说明
V | undefined	返回与键关联的值，默认返回undefined。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class ChildLRUCache<K, V> extends util.LRUCache<K, V> {
    public tC:number ;
    constructor() {
        super();
        this.tC = 0;
    }
    override createDefault(key: K): V|undefined {
        this.tC++;
        return undefined;
    }
}

let that = new ChildLRUCache<string, string>();
that.get('string');
let result = that.tC;
console.info('result = ' + result);
// 输出结果：result = 1

entries⁹⁺

entries(): IterableIterator<[K,V]>

允许迭代包含在这个对象中的所有键值对。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
[K, V]	返回一个可迭代数组。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.put(3, 15);
let pair:Iterable<Object[]> = pro.entries();
let arrayValue = Array.from(pair);
for (let value of arrayValue) {
  console.info(value[0]+ ', '+ value[1]);
  // 输出结果：
  // 2, 10
  // 3, 15
}

[Symbol.iterator]⁹⁺

[Symbol.iterator](): IterableIterator<[K, V]>

返回一个键值对形式的二维数组。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
[K, V]	返回一个键值对形式的二维数组。

示例：

let pro = new util.LRUCache<number, number>();
pro.put(2, 10);
pro.put(3, 15);
let pair:Iterable<Object[]> = pro[Symbol.iterator]();
let arrayValue = Array.from(pair);
for (let value of arrayValue) {
  console.info(value[0]+ ', '+ value[1]);
  // 输出结果：
  // 2, 10
  // 3, 15
}

$_iterator²⁰⁺

$_iterator(): IterableIterator<[K, V]>

返回一个键值对形式的二维数组。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

返回值：

类型	说明
IterableIterator<[K, V]>	返回一个键值对形式的二维数组。

示例：

let pro = new util.LRUCache<object, object>();
pro.put(2, 10);
pro.put(3, 15);
let pair:IterableIterator<[object, object]> = pro.$_iterator();
let arrayValue = Array.from(pair);
for (let value of arrayValue) {
  console.info(value[0]+ ', '+ value[1]);
  // 输出结果：
  // 2, 10
  // 3, 15
}
for (let value of pro) {
  console.info(value[0]+ ', '+ value[1]);
  // 输出结果：
  // 2, 10
  // 3, 15
}

ScopeComparable⁸⁺

ScopeComparable类型的值需要实现compareTo方法，确保传入的数据具有可比性。

系统能力： SystemCapability.Utils.Lang

compareTo⁸⁺

compareTo(other: ScopeComparable): boolean

比较两个值的大小，返回一个布尔值。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
other	ScopeComparable	是	表示要比较的值。

返回值：

类型	说明
boolean	调用compareTo的值大于等于传入的值返回true，否则返回false。

示例：

构造新类，实现compareTo方法。后续示例代码中，均以此Temperature类为例。

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

ScopeComparable<T>²⁰⁺

compareTo²⁰⁺

compareTo(other: T): boolean

比较两个值的大小，返回一个布尔值，T表示可以使用多种参数类型。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
other	T	是	表示要比较的值。

返回值：

类型	说明
boolean	调用compareTo的值大于等于传入的值返回true，否则返回false。

ScopeType⁸⁺

type ScopeType = ScopeComparable | number

用于表示范围中的值的类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

类型	说明
number	表示值的类型为数字，可取任意值。
ScopeComparable	表示值的类型为ScopeComparable，可取任意值。

ScopeType<T> ²⁰⁺

type ScopeType<T> = ScopeComparable<T>

用于表示范围中的值的类型。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

类型	说明
ScopeComparable<T>	表示值的类型为ScopeComparable<T>，可取任意值。

ScopeHelper⁹⁺

ScopeHelper接口用于描述一个字段的有效范围。ScopeHelper实例的构造函数用于创建具有指定下限和上限的对象，并要求这些对象必须具有可比性。

constructor⁹⁺

constructor(lowerObj: ScopeType, upperObj: ScopeType)

用于创建指定下限和上限的作用域实例的构造函数，返回一个ScopeHelper对象。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
lowerObj	ScopeType	是	指定作用域实例的下限。
upperObj	ScopeType	是	指定作用域实例的上限。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}
let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
console.info("range = " + range);
// 输出结果：range = [30, 40]

toString⁹⁺

toString(): string

该字符串化方法返回一个包含当前范围的字符串表示形式。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型	说明
string	返回包含当前范围对象的字符串表示形式。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.toString();
console.info("result = " + result);
// 输出结果：result = [30, 40]

intersect⁹⁺

intersect(range: ScopeHelper): ScopeHelper

获取给定范围和当前范围的交集。当交集为空集时，抛出异常。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
range	ScopeHelper	是	传入一个给定范围。

返回值：

类型	说明
ScopeHelper	返回给定范围和当前范围的交集。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);

intersect⁹⁺

intersect(lowerObj:ScopeType,upperObj:ScopeType):ScopeHelper

获取当前范围与给定下限和上限范围的交集。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
lowerObj	ScopeType	是	给定范围的下限。
upperObj	ScopeType	是	给定范围的上限。

返回值：

类型	说明
ScopeHelper	返回当前范围与给定下限和上限范围的交集。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = [35, 39]

getUpper⁹⁺

getUpper(): ScopeType

获取当前范围的上限。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
ScopeType	返回当前范围的上限值。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.getUpper();
console.info("result = " + result);
// 输出结果：result = 40

getLower⁹⁺

getLower(): ScopeType

获取当前范围的下限。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
ScopeType	返回当前范围的下限值。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.getLower();
console.info("result = " + result);
// 输出结果：result = 30

expand⁹⁺

expand(lowerObj: ScopeType,upperObj: ScopeType): ScopeHelper

创建并返回包括当前范围和给定下限和上限的并集。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
lowerObj	ScopeType	是	给定范围的下限。
upperObj	ScopeType	是	给定范围的上限。

返回值：

类型	说明
ScopeHelper	返回当前范围和给定下限和上限的并集。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = [30, 40]

expand⁹⁺

expand(range: ScopeHelper): ScopeHelper

创建并返回包括当前范围和给定范围的并集。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
range	ScopeHelper	是	传入一个给定范围。

返回值：

类型	说明
ScopeHelper	返回包括当前范围和给定范围的并集。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = [30, 40]

expand⁹⁺

expand(value: ScopeType): ScopeHelper

创建并返回包括当前范围和给定值的并集。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	ScopeType	是	传入一个给定值。

返回值：

类型	说明
ScopeHelper	返回包括当前范围和给定值的并集。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = [30, 40]

contains⁹⁺

contains(value: ScopeType): boolean

检查给定value是否包含在当前范围内。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	ScopeType	是	传入一个给定值。

返回值：

类型	说明
boolean	如果给定值包含在当前范围内返回true，否则返回false。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = true

contains⁹⁺

contains(range: ScopeHelper): boolean

检查给定range是否在当前范围内。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
range	ScopeHelper	是	传入一个给定范围。

返回值：

类型	说明
boolean	如果给定范围包含在当前范围内返回true，否则返回false。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = false

clamp⁹⁺

clamp(value: ScopeType): ScopeType

将给定值限定到当前范围内。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	ScopeType	是	传入的给定值。

返回值：

类型	说明
ScopeType	如果传入的value小于下限，则返回lowerObj；如果大于上限值则返回upperObj；如果在当前范围内，则返回value。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = 35

ScopeHelper<T extends ScopeComparable<T>>²⁰⁺

ScopeHelper<T extends ScopeComparable<T>> 接口用于描述一个字段的有效范围。ScopeHelper<T extends ScopeComparable<T>> 实例的构造函数用于创建具有指定下限和上限的对象，并要求这些对象必须具有可比性。

类型T继承自 ScopeComparable<T>

constructor²⁰⁺

constructor(lowerObj: T, upperObj: T)

用于创建指定下限和上限的作用域实例的构造函数，返回一个ScopeHelper对象。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
lowerObj	T	是	指定作用域实例的下限。
upperObj	T	是	指定作用域实例的上限。

toString²⁰⁺

toString(): string

该字符串化方法返回一个包含当前范围的字符串表示形式。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

返回值：

类型	说明
string	返回包含当前范围对象的字符串表示形式。

示例：

class Temperature implements util.ScopeType<Temperature>{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return `${this._temp}`
  }
}

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper<Temperature>(tempLower, tempUpper);
let result = range.toString();
console.info("result = " + result);
// 输出结果：result = [30, 40]

intersect²⁰⁺

intersect(range: ScopeHelper<T>): ScopeHelper<T>

获取给定范围和当前范围的交集。当交集为空集时，抛出异常。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
range	ScopeHelper<T>	是	传入一个给定范围。

返回值：

类型	说明
ScopeHelper<T>	返回给定范围和当前范围的交集。

示例：

class NumberType implements util.ScopeType<NumberType> {
  n: number
  constructor(n: number) {
    this.n = n
  }
  
  compareTo(other: NumberType): boolean {
    return this.n >= other.n
  }
  
  toString(): string {
    return `${this.n}`
  }
}

// 注：下文中示例代码使用的createScopeHelper()函数，其定义与此处相同。
function createScopeHelper(a: number, b: number): util.ScopeHelper<NumberType> {
  let a1 = new NumberType(a)
  let a2 = new NumberType(b)
  return new util.ScopeHelper<NumberType>(a1, a2)
}

let sh = createScopeHelper(10, 30)

let other = createScopeHelper(1, 11)
console.info(sh.intersect(other).getLower().n)
console.info(sh.intersect(other).getUpper().n)

other = createScopeHelper(10, 20)
console.info(sh.intersect(other).getLower().n)
console.info(sh.intersect(other).getUpper().n)

other = createScopeHelper(20, 300)
console.info(sh.intersect(other).getLower().n)
console.info(sh.intersect(other).getUpper().n)

other = createScopeHelper(0, 300)
console.info(sh.intersect(other).getLower().n)
console.info(sh.intersect(other).getUpper().n)

intersect²⁰⁺

intersect(lowerObj:T,upperObj:T):ScopeHelper<T>

获取当前范围与给定下限和上限范围的交集。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
lowerObj	T	是	给定范围的下限。
upperObj	T	是	给定范围的上限。

返回值：

类型	说明
ScopeHelper<T>	返回当前范围与给定下限和上限范围的交集。

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

class NumberType implements util.ScopeType<NumberType> {
  n: number
  constructor(n: number) {
    this.n = n
  }
  
  compareTo(other: NumberType): boolean {
      return this.n >= other.n
  }
  
  toString(): string {
      return `${this.n}`
  }
}

let sh = new util.ScopeHelper<NumberType>(new NumberType(10), new NumberType(30))

console.info(sh.intersect(new NumberType(5), new NumberType(25)).getLower().n)
console.info(sh.intersect(new NumberType(5), new NumberType(25)).getUpper().n)

getUpper²⁰⁺

getUpper(): T

获取当前范围的上限。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

返回值：

类型	说明
T	返回当前范围的上限值。

示例：

// 注：createScopeHelper()的定义参见上文intersect章节。
function testgetUpper() {
    let sh = createScopeHelper(10, 30)

    let other = createScopeHelper(1, 11)
    console.info(sh.intersect(other).getUpper().n) // 11

    other = createScopeHelper(10, 20)
    console.info(sh.intersect(other).getUpper().n) // 20

    other = createScopeHelper(20, 300)
    console.info(sh.intersect(other).getUpper().n) // 30

    other = createScopeHelper(0, 300)
    console.info(sh.intersect(other).getUpper().n) // 30
}

getLower²⁰⁺

getLower(): T

获取当前范围的下限。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

返回值：

类型	说明
T	返回当前范围的下限值。

示例：

// 注：createScopeHelper()的定义参见上文intersect章节。
function testgetLower() {
    let sh = createScopeHelper(10, 30)

    let other = createScopeHelper(1, 11)
    console.info(sh.intersect(other).getLower().n) // 10

    other = createScopeHelper(10, 20)
    console.info(sh.intersect(other).getLower().n) // 10

    other = createScopeHelper(20, 300)
    console.info(sh.intersect(other).getLower().n) // 20

    other = createScopeHelper(0, 300)
    console.info(sh.intersect(other).getLower().n) // 10
}

expand²⁰⁺

expand(lowerObj: T,upperObj: T): ScopeHelper<T>

创建并返回包括当前范围和给定下限和上限的并集。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
lowerObj	T	是	给定范围的下限。
upperObj	T	是	给定范围的上限。

返回值：

类型	说明
ScopeHelper<T>	返回当前范围和给定下限和上限的并集。

示例：

  class NumberType implements util.ScopeType<NumberType> {
    n: number
    constructor(n: number) {
      this.n = n
    }
    
    compareTo(other: NumberType): boolean {
        return this.n >= other.n
    }
    
    toString(): string {
        return `${this.n}`
    }
  }
  let sh = new util.ScopeHelper<NumberType>(new NumberType(10), new NumberType(30))

  let res = sh.expand(new NumberType(15), new NumberType(30))
  console.info(res.getLower().n); // 10
  console.info(res.getUpper().n); // 30

  res = sh.expand(new NumberType(15), new NumberType(20))
  console.info(res.getLower().n) // 10
  console.info(res.getUpper().n) // 30

  res = sh.expand(new NumberType(10), new NumberType(30))
  console.info(res.getLower().n) // 10
  console.info(res.getUpper().n) // 30

  res = sh.expand(new NumberType(5), new NumberType(40))
  console.info(res.getLower().n) // 5
  console.info(res.getUpper().n) // 40

expand²⁰⁺

expand(range: ScopeHelper<T>): ScopeHelper<T>

创建并返回包括当前范围和给定范围的并集。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
range	ScopeHelper<T>	是	传入一个给定范围。

返回值：

类型	说明
ScopeHelper<T>	返回包括当前范围和给定范围的并集。

示例：

// 注：createScopeHelper()的定义参见上文intersect章节。
let sh = createScopeHelper(10, 30)

let res = sh.expand(createScopeHelper(15, 30))
console.info(res.getLower().n) // 10
console.info(res.getUpper().n) // 30

res = sh.expand(createScopeHelper(15, 20))
console.info(res.getLower().n) // 10
console.info(res.getUpper().n) // 30

res = sh.expand(createScopeHelper(10, 30))
console.info(res.getLower().n) // 10
console.info(res.getUpper().n) // 30

res = sh.expand(createScopeHelper(5, 40))
console.info(res.getLower().n) // 5
console.info(res.getUpper().n) // 40

expand²⁰⁺

expand(value: T): ScopeHelper<T>

创建并返回包括当前范围和给定值的并集。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
value	T	是	传入一个给定值。

返回值：

类型	说明
ScopeHelper<T>	返回包括当前范围和给定值的并集。

示例：

  class NumberType implements util.ScopeType<NumberType> {
    n: number
    constructor(n: number) {
      this.n = n
    }
    
    compareTo(other: NumberType): boolean {
        return this.n >= other.n
    }
    
    toString(): string {
        return `${this.n}`
    }
  }
  let sh = new util.ScopeHelper<NumberType>(new NumberType(10), new NumberType(30))

  let res = sh.expand(new NumberType(5))
  console.info(res.getLower().n) // 5
  console.info(res.getUpper().n) // 30

  res = sh.expand(new NumberType(20))
  console.info(res.getLower().n) // 10
  console.info(res.getUpper().n) //30

  res = sh.expand(new NumberType(30))
  console.info(res.getLower().n) // 10
  console.info(res.getUpper().n) // 30

  res = sh.expand(new NumberType(40))
  console.info(res.getLower().n) // 10
  console.info(res.getUpper().n) // 40

contains²⁰⁺

contains(value: ScopeType<T>): boolean

检查给定value是否包含在当前范围内。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
value	ScopeType<T>	是	传入一个给定值。

返回值：

类型	说明
boolean	如果给定值包含在当前范围内返回true，否则返回false。

示例：

let sh = createScopeHelper(10, 30)

console.info(sh.contains(new NumberType(10))) // true
console.info(sh.contains(new NumberType(23))) // true
console.info(sh.contains(new NumberType(30))) // true
console.info(sh.contains(new NumberType(40))) // false
console.info(sh.contains(new NumberType(0))) // false

contains²⁰⁺

contains(range: ScopeHelper<T>): boolean

检查给定range是否在当前范围内。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
range	ScopeHelper<T>	是	传入一个给定范围。

返回值：

类型	说明
boolean	如果给定范围包含在当前范围内返回true，否则返回false。

示例：

let sh = createScopeHelper(10, 30)

console.info(sh.contains(createScopeHelper(10, 30))) // true
console.info(sh.contains(createScopeHelper(10, 20))) // true
console.info(sh.contains(createScopeHelper(15, 18))) // true
console.info(sh.contains(createScopeHelper(10, 40))) // false
console.info(sh.contains(createScopeHelper(1, 30))) // false

clamp²⁰⁺

clamp(value: T): T

将给定值限定到当前范围内。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.2。

参数：

参数名	类型	必填	说明
value	T	是	传入的给定值。

返回值：

类型	说明
T	如果传入的value小于下限，则返回lowerObj；如果大于上限值则返回upperObj；如果在当前范围内，则返回value。

示例：

let sh = createScopeHelper(10, 30)

console.info(sh.clamp(new NumberType(5)).n) // 10
console.info(sh.clamp(new NumberType(10)).n) // 10
console.info(sh.clamp(new NumberType(23)).n) // 23
console.info(sh.clamp(new NumberType(30)).n) // 30
console.info(sh.clamp(new NumberType(1000)).n) // 30

Base64Helper⁹⁺

Base64Helper类提供Base64编解码和Base64URL编解码功能。Base64编码表包含A-Z、a-z、0-9这62个字符，以及"+"和"/"这两个特殊字符。在编码时，将原始数据按3个字节一组进行划分，得到若干个6位的数字，然后使用Base64编码表中对应的字符来表示这些数字。如果最后剩余1或2个字节，则需要使用"="字符进行补齐。Base64URL编码表包含A-Z、a-z、0-9以及"-"和"_"64个字符，Base64URL编码结果不含"="。

constructor⁹⁺

constructor()

Base64Helper的构造函数。

系统能力： SystemCapability.Utils.Lang

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

示例：

let base64 = new util.Base64Helper();

encodeSync⁹⁺

encodeSync(src: Uint8Array, options?: Type): Uint8Array

通过输入参数编码后输出Uint8Array对象。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
src	Uint8Array	是	待编码Uint8Array对象。
options12+	Type	否	从API version 12开始支持该参数，表示对应的编码格式。 此参数可选，可选值为：util.Type.BASIC和util.Type.BASIC_URL_SAFE，默认值为：util.Type.BASIC。 util.Type.BASIC表示Base64编码。 util.Type.BASIC_URL_SAFE表示Base64URL编码。

返回值：

类型	说明
Uint8Array	返回编码后的Uint8Array对象。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let base64Helper = new util.Base64Helper();
let array = new Uint8Array([115,49,51]);
let result = base64Helper.encodeSync(array);
console.info("result = " + result);
// 输出结果：result = 99,122,69,122

encodeToStringSync⁹⁺

encodeToStringSync(src: Uint8Array, options?: Type): string

通过输入参数编码后输出对应文本。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
src	Uint8Array	是	待编码Uint8Array对象。
options10+	Type	否	从API version 10开始支持该参数，表示对应的编码格式。 此参数可选，可选值为：util.Type.BASIC，util.Type.MIME，util.Type.BASIC_URL_SAFE 和util.Type.MIME_URL_SAFE，默认值为：util.Type.BASIC。 - 当参数取值为util.Type.BASIC，表示Base64编码，返回值没有回车符、换行符。 - 当参数取值为util.Type.MIME，表示使用Base64编码。如果返回值超过76个字符，则会在每76个字符处进行换行，并以'\r\n'结束每行。如果返回值少于76个字符，则会抛出异常。 - 当参数取值为util.Type.BASIC_URL_SAFE，表示Base64URL编码，返回值没有回车符、换行符。 - 当参数取值为util.Type.MIME_URL_SAFE，表示Base64URL编码，返回值每一行不超过76个字符，而且每行以'\r\n'符结束。

返回值：

类型	说明
string	返回编码后的字符串。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let base64Helper = new util.Base64Helper();
let array = new Uint8Array([77,97,110,105,115,100,105,115,116,105,110,103,117,105,115,104,101,100,110,111,116,111,110,108,121,98,121,104,105,115,114,101,97,115,111,110,98,117,116,98,121,116,104,105,115,115,105,110,103,117,108,97,114,112,97,115,115,105,111,110,102,114,111,109,111,116,104,101,114,97,110,105,109,97,108,115,119,104,105,99,104,105,115,97,108,117,115,116,111,102,116,104,101,109,105,110,100,101,120,99,101,101,100,115,116,104,101,115,104,111,114,116,118,101,104,101,109,101,110,99,101,111,102,97,110,121,99,97,114,110,97,108,112,108,101,97,115,117,114,101]);
let result = base64Helper.encodeToStringSync(array, util.Type.MIME);
console.info("result = " + result);
/*
输出结果：result = TWFuaXNkaXN0aW5ndWlzaGVkbm90b25seWJ5aGlzcmVhc29uYnV0Ynl0aGlzc2luZ3VsYXJwYXNz
aW9uZnJvbW90aGVyYW5pbWFsc3doaWNoaXNhbHVzdG9mdGhlbWluZGV4Y2VlZHN0aGVzaG9ydHZl
aGVtZW5jZW9mYW55Y2FybmFscGxlYXN1cmU=
*/

decodeSync⁹⁺

decodeSync(src: Uint8Array | string, options?: Type): Uint8Array

通过输入参数解码后输出对应Uint8Array对象。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
src	Uint8Array | string	是	待解码Uint8Array对象或者字符串。
options10+	Type	否	从API version 10开始支持该参数，表示对应的解码格式。 此参数可选，可选值为：util.Type.BASIC，util.Type.MIME，util.Type.BASIC_URL_SAFE和util.Type.MIME_URL_SAFE，默认值为：util.Type.BASIC。 - 当参数取值为util.Type.BASIC，表示Base64解码。 - 当参数取值为util.Type.MIME，表示Base64解码，src入参包含回车符、换行符。 - 当参数取值为util.Type.BASIC_URL_SAFE，表示Base64URL解码。 - 当参数取值为util.Type.MIME_URL_SAFE，表示Base64URL解码，src入参包含回车符、换行符。

返回值：

类型	说明
Uint8Array	返回解码后新分配的Uint8Array对象。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let base64Helper = new util.Base64Helper();
let buff = 'TWFuaXNkaXN0aW5ndWlzaGVkbm90b25seWJ5aGlzcmVhc29uYnV0Ynl0aGlzc2luZ3VsYXJwYXNz\r\naW9uZnJvbW90aGVyYW5pbWFsc3doaWNoaXNhbHVzdG9mdGhlbWluZGV4Y2VlZHN0aGVzaG9ydHZl\r\naGVtZW5jZW9mYW55Y2FybmFscGxlYXN1cmU=\r\n';
let result = base64Helper.decodeSync(buff, util.Type.MIME);
console.info("result = " + result);
/*
输出结果：result = 77,97,110,105,115,100,105,115,116,105,110,103,117,105,115,104,101,100,110,111,116,111,110,108,121,98,121,104,105,115,114,101,97,115,111,110,98,117,116,98,121,116,104,105,115,115,105,110,103,117,108,97,114,112,97,115,115,105,111,110,102,114,111,109,111,116,104,101,114,97,110,105,109,97,108,115,119,104,105,99,104,105,115,97,108,117,115,116,111,102,116,104,101,109,105,110,100,101,120,99,101,101,100,115,116,104,101,115,104,111,114,116,118,101,104,101,109,101,110,99,101,111,102,97,110,121,99,97,114,110,97,108,112,108,101,97,115,117,114,101
*/

encode⁹⁺

encode(src: Uint8Array, options?: Type): Promise<Uint8Array>

通过输入参数异步编码后输出对应Uint8Array对象。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
src	Uint8Array	是	异步编码输入Uint8Array对象。
options12+	Type	否	从API version 12开始支持该参数，表示对应的编码格式。 此参数可选，可选值为：util.Type.BASIC和util.Type.BASIC_URL_SAFE，默认值为：util.Type.BASIC。 util.Type.BASIC表示Base64编码。 util.Type.BASIC_URL_SAFE表示Base64URL编码。

返回值：

类型	说明
Promise<Uint8Array>	返回异步编码后新分配的Uint8Array对象。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let base64Helper = new util.Base64Helper();
let array = new Uint8Array([115,49,51]);
base64Helper.encode(array).then((val) => {
  console.info(val.toString());
  // 输出结果：99,122,69,122
})

encodeToString⁹⁺

encodeToString(src: Uint8Array, options?: Type): Promise<string>

通过输入参数异步编码后输出对应文本。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
src	Uint8Array	是	异步编码输入Uint8Array对象。
options10+	Type	否	从API version 10开始支持该参数，表示对应的编码格式。 此参数可选，可选值为：util.Type.BASIC，util.Type.MIME，util.Type.BASIC_URL_SAFE和util.Type.MIME_URL_SAFE，默认值为：util.Type.BASIC。 - 当参数取值为util.Type.BASIC，表示Base64编码，返回值没有回车符、换行符。 - 当参数取值为util.Type.MIME，表示Base64编码，返回值每一行不超过76个字符，而且每行以'\r\n'符结束。 - 当参数取值为util.Type.BASIC_URL_SAFE，表示Base64URL编码，返回值没有回车符、换行符。 - 当参数取值为util.Type.MIME_URL_SAFE，表示Base64URL编码，返回值每一行不超过76个字符，而且每行以'\r\n'符结束。

返回值：

类型	说明
Promise<string>	返回异步编码后的字符串。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let base64Helper = new util.Base64Helper();
let array = new Uint8Array([77,97,110,105,115,100,105,115,116,105,110,103,117,105,115,104,101,100,110,111,116,111,110,108,121,98,121,104,105,115,114,101,97,115,111,110,98,117,116,98,121,116,104,105,115,115,105,110,103,117,108,97,114,112,97,115,115,105,111,110,102,114,111,109,111,116,104,101,114,97,110,105,109,97,108,115,119,104,105,99,104,105,115,97,108,117,115,116,111,102,116,104,101,109,105,110,100,101,120,99,101,101,100,115,116,104,101,115,104,111,114,116,118,101,104,101,109,101,110,99,101,111,102,97,110,121,99,97,114,110,97,108,112,108,101,97,115,117,114,101]);
base64Helper.encodeToString(array, util.Type.MIME).then((val) => {
  console.info(val);
  /*
  输出结果：TWFuaXNkaXN0aW5ndWlzaGVkbm90b25seWJ5aGlzcmVhc29uYnV0Ynl0aGlzc2luZ3VsYXJwYXNz
  aW9uZnJvbW90aGVyYW5pbWFsc3doaWNoaXNhbHVzdG9mdGhlbWluZGV4Y2VlZHN0aGVzaG9ydHZl
  aGVtZW5jZW9mYW55Y2FybmFscGxlYXN1cmU=
  */

})

decode⁹⁺

decode(src: Uint8Array | string, options?: Type): Promise<Uint8Array>

通过输入参数异步解码后输出对应Uint8Array对象。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
src	Uint8Array | string	是	异步解码输入Uint8Array对象或者字符串。
options10+	Type	否	从API version 10开始支持该参数，表示对应的解码格式。 此参数可选，可选值为：util.Type.BASIC，util.Type.MIME，util.Type.BASIC_URL_SAFE和util.Type.MIME_URL_SAFE，默认值为：util.Type.BASIC。 - 当参数取值为util.Type.BASIC时，表示Base64解码。 - 当参数取值为util.Type.MIME时，表示Base64解码，src入参包含回车符、换行符。 - 当参数取值为util.Type.BASIC_URL_SAFE，表示Base64URL解码。 - 当参数取值为util.Type.MIME_URL_SAFE，表示Base64URL解码，src入参包含回车符、换行符。

返回值：

类型	说明
Promise<Uint8Array>	返回异步解码后新分配的Uint8Array对象。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let base64Helper = new util.Base64Helper();
let array = 'TWFuaXNkaXN0aW5ndWlzaGVkbm90b25seWJ5aGlzcmVhc29uYnV0Ynl0aGlzc2luZ3VsYXJwYXNz\r\naW9uZnJvbW90aGVyYW5pbWFsc3doaWNoaXNhbHVzdG9mdGhlbWluZGV4Y2VlZHN0aGVzaG9ydHZl\r\naGVtZW5jZW9mYW55Y2FybmFscGxlYXN1cmU=\r\n';
base64Helper.decode(array, util.Type.MIME).then((val) => {
  console.info(val.toString());
  /*
  输出结果：77,97,110,105,115,100,105,115,116,105,110,103,117,105,115,104,101,100,110,111,116,111,110,108,121,98,121,104,105,115,114,101,97,115,111,110,98,117,116,98,121,116,104,105,115,115,105,110,103,117,108,97,114,112,97,115,115,105,111,110,102,114,111,109,111,116,104,101,114,97,110,105,109,97,108,115,119,104,105,99,104,105,115,97,108,117,115,116,111,102,116,104,101,109,105,110,100,101,120,99,101,101,100,115,116,104,101,115,104,111,114,116,118,101,104,101,109,101,110,99,101,111,102,97,110,121,99,97,114,110,97,108,112,108,101,97,115,117,114,101
  */
})

StringDecoder¹²⁺

提供将二进制流解码为字符串的能力。支持的编码类型包括：utf-8、iso-8859-2、koi8-r、macintosh、windows-1250、windows-1251、gbk、gb18030、big5、utf-16be、utf-16le等。

constructor¹²⁺

constructor(encoding?: string)

StringDecoder的构造函数。

原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
encoding	string	否	输入数据的编码类型。默认值：'utf-8'。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let decoder = new util.StringDecoder();

write¹²⁺

write(chunk: string | Uint8Array): string

返回一个解码后的字符串，确保Uint8Array末尾的任何不完整的多字节字符从返回的字符串中被过滤，并保存在一个内部的buffer中用于下次调用。

原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
chunk	string | Uint8Array	是	需要解码的字符串。会根据输入的编码类型进行解码，参数为Uint8Array时会正常解码，参数为string类型时会原路返回。

返回值：

类型	说明
string	返回解码后的字符串。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let decoder = new util.StringDecoder('utf-8');
let input =  new Uint8Array([0xE4, 0xBD, 0xA0, 0xE5, 0xA5, 0xBD]);
const decoded = decoder.write(input);
console.info("decoded:", decoded);
// 输出结果：decoded: 你好

end¹²⁺

end(chunk?: string | Uint8Array): string

结束解码过程，以字符串形式返回存储在内部缓冲区中的任何剩余输入。

原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
chunk	string | Uint8Array	否	需要解码的字符串。默认为undefined。

返回值：

类型	说明
string	返回解码后的字符串。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let decoder = new util.StringDecoder('utf-8');
let input = new Uint8Array([0xE4, 0xBD, 0xA0, 0xE5, 0xA5, 0xBD]);
const writeString = decoder.write(input.slice(0, 5));
const endString = decoder.end(input.slice(5));
console.info("writeString:", writeString);
// 输出结果：writeString: 你
console.info("endString:", endString);
// 输出结果：endString: 好

Type¹⁰⁺

Base64编码格式枚举。

系统能力： SystemCapability.Utils.Lang

名称	值	说明
BASIC	0	表示BASIC编码格式。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
MIME	1	表示MIME编码格式。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
BASIC_URL_SAFE12+	2	表示BASIC_URL_SAFE编码格式。 从API version 12开始支持此枚举。原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。
MIME_URL_SAFE12+	3	表示MIME_URL_SAFE编码格式。 从API version 12开始支持此枚举。原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

types⁸⁺

types为不同类型的内置对象提供类型检查，可以避免由于类型错误导致的异常或崩溃。该模块包含了多个工具函数，用于判断JS对象是否属于各种类型例如：ArrayBuffer、Map、Set等。

constructor⁸⁺

constructor()

Types的构造函数。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

示例：

let type = new util.types();

isAnyArrayBuffer⁸⁺

isAnyArrayBuffer(value: Object): boolean

检查输入的value是否是ArrayBuffer或SharedArrayBuffer类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是ArrayBuffer或SharedArrayBuffer类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isAnyArrayBuffer(new ArrayBuffer(0));
console.info("result = " + result);
// 输出结果：result = true

isArrayBufferView⁸⁺

isArrayBufferView(value: Object): boolean

检查输入的value是否是内置ArrayBufferView辅助类型。

ArrayBufferView辅助类型包括：Int8Array、Int16Array、Int32Array、Uint8Array、Uint8ClampedArray、Uint32Array、Float32Array、Float64Array、DataView。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的ArrayBufferView辅助类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isArrayBufferView(new Int8Array([]));
console.info("result = " + result);
// 输出结果：result = true

isArgumentsObject⁸⁺

isArgumentsObject(value: Object): boolean

检查输入的value是否是一个arguments对象。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是一个arguments对象为true，反之为false。

示例：

let type = new util.types();
function foo() {
    let result = type.isArgumentsObject(arguments);
    console.info("result = " + result);
}
let f = foo();
// 输出结果：result = true

isArrayBuffer⁸⁺

isArrayBuffer(value: Object): boolean

检查输入的value是否是ArrayBuffer类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的ArrayBuffer类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isArrayBuffer(new ArrayBuffer(0));
console.info("result = " + result);
// 输出结果：result = true

isAsyncFunction⁸⁺

isAsyncFunction(value: Object): boolean

检查输入的value是否是一个异步函数类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的异步函数类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isAsyncFunction(async () => {});
console.info("result = " + result);
// 输出结果：result = true

isBooleanObject^(deprecated)

isBooleanObject(value: Object): boolean

检查输入的value是否是一个Boolean对象类型。

说明：

从API version 8开始支持，从API version 14开始废弃，没有替代接口。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Boolean对象类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isBooleanObject(new Boolean(true));
console.info("result = " + result);
// 输出结果：result = true

isBoxedPrimitive^(deprecated)

isBoxedPrimitive(value: Object): boolean

检查输入的value是否是Boolean或Number或String或Symbol对象类型。

说明：

从API version 8开始支持，从API version 14开始废弃，没有替代接口。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Boolean或Number或String或Symbol对象类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isBoxedPrimitive(new Boolean(false));
console.info("result = " + result);
// 输出结果：result = true

isDataView⁸⁺

isDataView(value: Object): boolean

检查输入的value是否是DataView类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的DataView对象类型为true，反之为false。

示例：

let type = new util.types();
const ab = new ArrayBuffer(20);
let result = type.isDataView(new DataView(ab));
console.info("result = " + result);
// 输出结果：result = true

isDate⁸⁺

isDate(value: Object): boolean

检查输入的value是否是Date类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Date对象类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isDate(new Date());
console.info("result = " + result);
// 输出结果：result = true

isExternal⁸⁺

isExternal(value: Object): boolean

检查输入的value是否是native External类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含native External类型为true，反之为false。

示例：

// /entry/src/main/cpp/napi_init.cpp
#include "napi/native_api.h"
#include <js_native_api.h>
#include <stdlib.h>

napi_value result;
static napi_value Testexternal(napi_env env, napi_callback_info info) {
    int* raw = (int*) malloc(1024);
    napi_status status = napi_create_external(env, (void*) raw, NULL, NULL, &result);
    if (status != napi_ok) {
        napi_throw_error(env, NULL, "create external failed");
        return NULL;
    }
    return result;
}

EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
    napi_property_descriptor desc[] = {
        {"testexternal", nullptr, Testexternal, nullptr, nullptr, nullptr, napi_default, nullptr},
    };
    napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
    return exports;
}
EXTERN_C_END
// 此处已省略模块注册的代码, 你可能需要自行注册Testexternal方法
...

import testNapi from 'libentry.so';

let type = new util.types();
const data = testNapi.testexternal();
let result = type.isExternal(data);

let result01 = type.isExternal(true);
console.info("result = " + result);
console.info("result01 = " + result01);
// 输出结果：result = true
// 输出结果：result01 = false

isFloat32Array⁸⁺

isFloat32Array(value: Object): boolean

检查输入的value是否是Float32Array数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Float32Array数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isFloat32Array(new Float32Array());
console.info("result = " + result);
// 输出结果：result = true

isFloat64Array⁸⁺

isFloat64Array(value: Object): boolean

检查输入的value是否是Float64Array数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Float64Array数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isFloat64Array(new Float64Array());
console.info("result = " + result);
// 输出结果：result = true

isGeneratorFunction⁸⁺

isGeneratorFunction(value: Object): boolean

检查输入的value是否是generator函数类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的generator函数类型为true，反之为false。

示例：

// /entry/src/main/ets/pages/test.ts
export function* foo() {}

import { foo } from './test'

let type = new util.types();
let result = type.isGeneratorFunction(foo);
console.info("result = " + result);
// 输出结果：result = true

isGeneratorObject⁸⁺

isGeneratorObject(value: Object): boolean

检查输入的value是否是generator对象类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的generator对象类型为true，反之为false。

示例：

// /entry/src/main/ets/pages/test.ts
function* foo() {}
export const generator = foo();

import { generator } from './test'

let type = new util.types();
let result = type.isGeneratorObject(generator);
console.info("result = " + result);
// 输出结果：result = true

isInt8Array⁸⁺

isInt8Array(value: Object): boolean

检查输入的value是否是Int8Array数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Int8Array数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isInt8Array(new Int8Array([]));
console.info("result = " + result);
// 输出结果：result = true

isInt16Array⁸⁺

isInt16Array(value: Object): boolean

检查输入的value是否是Int16Array数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Int16Array数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isInt16Array(new Int16Array([]));
console.info("result = " + result);
// 输出结果：result = true

isInt32Array⁸⁺

isInt32Array(value: Object): boolean

检查输入的value是否是Int32Array数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Int32Array数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isInt32Array(new Int32Array([]));
console.info("result = " + result);
// 输出结果：result = true

isMap⁸⁺

isMap(value: Object): boolean

检查输入的value是否是Map类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Map类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isMap(new Map());
console.info("result = " + result);
// 输出结果：result = true

isMapIterator⁸⁺

isMapIterator(value: Object): boolean

检查输入的value是否是Map的Iterator类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Map的Iterator类型为true，反之为false。

示例：

let type = new util.types();
const map : Map<number,number> = new Map();
let result = type.isMapIterator(map.keys());
console.info("result = " + result);
// 输出结果：result = true

isNativeError⁸⁺

isNativeError(value: Object): boolean

检查输入的value是否是Error类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Error类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isNativeError(new TypeError());
console.info("result = " + result);
// 输出结果：result = true

isNumberObject^(deprecated)

isNumberObject(value: Object): boolean

检查输入的value是否是Number对象类型。

说明：

从API version 8开始支持，从API version 14开始废弃，没有替代接口。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Number对象类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isNumberObject(new Number(0));
console.info("result = " + result);
// 输出结果：result = true

isPromise⁸⁺

isPromise(value: Object): boolean

检查输入的value是否是Promise类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Promise类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isPromise(Promise.resolve(1));
console.info("result = " + result);
// 输出结果：result = true

isProxy⁸⁺

isProxy(value: Object): boolean

检查输入的value是否是Proxy类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Proxy类型为true，反之为false。

示例：

class Target{
}
let type = new util.types();
const target : Target = {};
const proxy = new Proxy(target, target);
let result = type.isProxy(proxy);
console.info("result = " + result);
// 输出结果：result = true

isRegExp⁸⁺

isRegExp(value: Object): boolean

检查输入的value是否是RegExp类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的RegExp类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isRegExp(new RegExp('abc'));
console.info("result = " + result);
// 输出结果：result = true

isSet⁸⁺

isSet(value: Object): boolean

检查输入的value是否是Set类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Set类型为true，反之为false。

示例：

let type = new util.types();
let set : Set<number> = new Set();
let result = type.isSet(set);
console.info("result = " + result);
// 输出结果：result = true

isSetIterator⁸⁺

isSetIterator(value: Object): boolean

检查输入的value是否是Set的Iterator类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Set的Iterator类型为true，反之为false。

示例：

let type = new util.types();
const set : Set<number> = new Set();
let result = type.isSetIterator(set.keys());
console.info("result = " + result);
// 输出结果：result = true

isStringObject^(deprecated)

isStringObject(value: Object): boolean

检查输入的value是否是String对象类型。

说明：

从API version 8开始支持，从API version 14开始废弃，没有替代接口。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的String对象类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isStringObject(new String('foo'));
console.info("result = " + result);
// 输出结果：result = true

isSymbolObject^(deprecated)

isSymbolObject(value: Object): boolean

检查输入的value是否是Symbol对象类型。

说明：

从API version 8开始支持，从API version 14开始废弃，没有替代接口。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Symbol对象类型为true，反之为false。

示例：

// /entry/src/main/ets/pages/test.ts
export const symbols = Symbol('foo');

import { symbols } from './test'

let type = new util.types();
let result = type.isSymbolObject(Object(symbols));
console.info("result = " + result);
// 输出结果：result = true

isTypedArray⁸⁺

isTypedArray(value: Object): boolean

检查输入的value是否是TypedArray类型的辅助类型。

TypedArray类型的辅助类型，包括Int8Array、Int16Array、Int32Array、Uint8Array、Uint8ClampedArray、Uint16Array、Uint32Array、Float32Array、Float64Array、BigInt64Array、BigUint64Array。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的TypedArray包含的类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isTypedArray(new Float64Array([]));
console.info("result = " + result);
// 输出结果：result = true

isUint8Array⁸⁺

isUint8Array(value: Object): boolean

检查输入的value是否是Uint8Array数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Uint8Array数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isUint8Array(new Uint8Array([]));
console.info("result = " + result);
// 输出结果：result = true

isUint8ClampedArray⁸⁺

isUint8ClampedArray(value: Object): boolean

检查输入的value是否是Uint8ClampedArray数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Uint8ClampedArray数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isUint8ClampedArray(new Uint8ClampedArray([]));
console.info("result = " + result);
// 输出结果：result = true

isUint16Array⁸⁺

isUint16Array(value: Object): boolean

检查输入的value是否是Uint16Array数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Uint16Array数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isUint16Array(new Uint16Array([]));
console.info("result = " + result);
// 输出结果：result = true

isUint32Array⁸⁺

isUint32Array(value: Object): boolean

检查输入的value是否是Uint32Array数组类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Uint32Array数组类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isUint32Array(new Uint32Array([]));
console.info("result = " + result);
// 输出结果：result = true

isWeakMap⁸⁺

isWeakMap(value: Object): boolean

检查输入的value是否是WeakMap类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的WeakMap类型为true，反之为false。

示例：

let type = new util.types();
let value : WeakMap<object, number> = new WeakMap();
let result = type.isWeakMap(value);
console.info("result = " + result);
// 输出结果：result = true

isWeakSet⁸⁺

isWeakSet(value: Object): boolean

检查输入的value是否是WeakSet类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的WeakSet类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isWeakSet(new WeakSet());
console.info("result = " + result);
// 输出结果：result = true

isBigInt64Array⁸⁺

isBigInt64Array(value: Object): boolean

检查输入的value是否是BigInt64Array类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的BigInt64Array类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isBigInt64Array(new BigInt64Array([]));
console.info("result = " + result);
// 输出结果：result = true

isBigUint64Array⁸⁺

isBigUint64Array(value: Object): boolean

检查输入的value是否是BigUint64Array类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的BigUint64Array类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isBigUint64Array(new BigUint64Array([]));
console.info("result = " + result);
// 输出结果：result = true

isModuleNamespaceObject⁸⁺

isModuleNamespaceObject(value: Object): boolean

检查输入的value是否是Module Namespace Object类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的Module Namespace Object类型为true，反之为false。

示例：

// /entry/src/main/ets/pages/test.ts
export function func() {
  console.info("hello world");
}

import * as nameSpace from './test';

let type = new util.types();
let result = type.isModuleNamespaceObject(nameSpace);
console.info("result = " + result);
// 输出结果：result = true

isSharedArrayBuffer⁸⁺

isSharedArrayBuffer(value: Object): boolean

检查输入的value是否是SharedArrayBuffer类型。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
value	Object	是	待检测对象。

返回值：

类型	说明
boolean	判断的结果，如果是内置包含的SharedArrayBuffer类型为true，反之为false。

示例：

let type = new util.types();
let result = type.isSharedArrayBuffer(new SharedArrayBuffer(0));
console.info("result = " + result);
// 输出结果：result = true

LruBuffer^(deprecated)

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache⁹⁺替代。

属性

系统能力： 以下各项对应的系统能力均为SystemCapability.Utils.Lang。

ArkTS版本： 该接口仅适用于ArkTS1.1。

名称	类型	可读	可写	说明
length	number	是	否	当前缓冲区中值的总数。

示例：

let pro : util.LruBuffer<number,number>= new util.LruBuffer();
pro.put(2,10);
pro.put(1,8);
let result = pro.length;
console.info("result = " + result);
// 输出结果：result = 2

constructor^(deprecated)

constructor(capacity?: number)

默认构造函数用于创建一个新的LruBuffer实例，默认容量为64。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.constructor⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
capacity	number	否	指示要为缓冲区自定义的容量，默认值为64。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();

updateCapacity^(deprecated)

updateCapacity(newCapacity: number): void

将缓冲区容量更新为指定容量，如果newCapacity小于或等于0，则抛出异常。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.updateCapacity⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
newCapacity	number	是	指示要为缓冲区自定义的容量。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.updateCapacity(100);

toString^(deprecated)

toString(): string

返回对象的字符串表示形式。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.toString⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
string	返回对象的字符串表示形式。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
pro.remove(20);
let result = pro.toString();
console.info("result = " + result);
// 输出结果：result = Lrubuffer[ maxSize = 64, hits = 1, misses = 0, hitRate = 100% ]

getCapacity^(deprecated)

getCapacity(): number

获取当前缓冲区的容量。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.getCapacity⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
number	返回当前缓冲区的容量。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
let result = pro.getCapacity();
console.info("result = " + result);
// 输出结果：result = 64

clear^(deprecated)

clear(): void

从当前缓冲区清除键值对。后续会调用afterRemoval()方法执行后续操作。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.clear⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

示例：

let pro : util.LruBuffer<number,number> = 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.getCreateCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
number	返回createDefault()返回值的次数。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(1,8);
let result = pro.getCreateCount();
console.info("result = " + result);
// 输出结果：result = 0

getMissCount^(deprecated)

getMissCount(): number

获取查询值不匹配的次数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.getMissCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
number	返回查询值不匹配的次数。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
let result = pro.getMissCount();
console.info("result = " + result);
// 输出结果：result = 0

getRemovalCount^(deprecated)

getRemovalCount(): number

获取从缓冲区中逐出值的次数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.getRemovalCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
number	返回从缓冲区中驱逐的次数。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
pro.updateCapacity(2);
pro.put(50,22);
let result = pro.getRemovalCount();
console.info("result = " + result);
// 输出结果：result = 0

getMatchCount^(deprecated)

getMatchCount(): number

获取查询值匹配成功的次数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.getMatchCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
number	返回查询值匹配成功的次数。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
let result = pro.getMatchCount();
console.info("result = " + result);
// 输出结果：result = 1

getPutCount^(deprecated)

getPutCount(): number

获取将值添加到缓冲区的次数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.getPutCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
number	返回将值添加到缓冲区的次数。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
let result = pro.getPutCount();
console.info("result = " + result);
// 输出结果：result = 1

isEmpty^(deprecated)

isEmpty(): boolean

检查当前缓冲区是否为空。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.isEmpty⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
boolean	如果当前缓冲区不包含任何值，则返回true。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
let result = pro.isEmpty();
console.info("result = " + result);
// 输出结果：result = false

get^(deprecated)

get(key: K): V | undefined

表示要查询的键。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.get⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
key	K	是	要查询的键。

返回值：

类型	说明
V | undefined	如果指定的键存在于缓冲区中，则返回与键关联的值；否则返回undefined。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
let result  = pro.get(2);
console.info("result = " + result);
// 输出结果：result = 10

put^(deprecated)

put(key: K,value: V): V

将键值对添加到缓冲区。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.put⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
key	K	是	要添加的密钥。
value	V	是	指示与要添加的键关联的值。

返回值：

类型	说明
V	返回与添加的键关联的值；如果要添加的键已经存在，则返回原始值，如果键或值为空，则抛出此异常。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
let result = pro.put(2,10);
console.info("result = " + result);
// 输出结果：result = 10

values^(deprecated)

values(): V[]

获取当前缓冲区中所有值从最近访问到最近最少访问的顺序列表。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.values⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
V []	按从最近访问到最近最少访问的顺序返回当前缓冲区中所有值的列表。

示例：

let pro : util.LruBuffer<number|string,number|string> = new util.LruBuffer();
pro.put(2,10);
pro.put(2,"anhu");
pro.put("afaf","grfb");
let result = pro.values();
console.info("result = " + result);
// 输出结果：result = anhu,grfb

keys^(deprecated)

keys(): K[]

获取当前缓冲区中所有键从最近访问到最近最少访问的升序列表。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.keys⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
K []	按升序返回当前缓冲区中所有键的列表，从最近访问到最近最少访问。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
let result = pro.keys();
console.info("result = " + result);
// 输出结果：result = 2

remove^(deprecated)

remove(key: K): V | undefined

从当前缓冲区中删除指定的键及其关联的值。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.remove⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
key	K	是	要删除的密钥。

返回值：

类型	说明
V | undefined	返回一个包含已删除键值对的Optional对象；如果key不存在，则返回一个空的Optional对象，如果key为null，则抛出异常。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
let result = pro.remove(20);
console.info("result = " + result);
// 输出结果：result = undefined

afterRemoval^(deprecated)

afterRemoval(isEvict: boolean,key: K,value: V,newValue: V): void

删除值后执行后续操作。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.afterRemoval⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
isEvict	boolean	是	因容量不足而调用该方法时，参数值为true，其他情况为false。
key	K	是	表示删除的键。
value	V	是	表示删除的值。
newValue	V	是	如果已调用put方法并且要添加的键已经存在，则参数值是关联的新值。其他情况下参数值为空。

示例：

class ChildLruBuffer<K, V> extends util.LruBuffer<K, V> {
  constructor(capacity?: number) {
    super(capacity);
  }

  afterRemoval(isEvict: boolean, key: K, value: V, newValue: V): void {
    if (isEvict === true) {
      console.info('key: ' + key);
      // 输出结果：key: 11
      console.info('value: ' + value);
      // 输出结果：value: 1
      console.info('newValue: ' + newValue);
      // 输出结果：newValue: null
    }
  }
}
let lru: ChildLruBuffer<number, number> = new ChildLruBuffer(2);
lru.put(11, 1);
lru.put(22, 2);
lru.put(33, 3);

contains^(deprecated)

contains(key: K): boolean

检查当前缓冲区是否包含指定的键。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.contains⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
key	K	是	表示要检查的键。

返回值：

类型	说明
boolean	如果缓冲区包含指定的键，则返回 true。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
let result = pro.contains(20);
console.info('result = ' + result);
// 输出结果：result = false

createDefault^(deprecated)

createDefault(key: K): V

如果未计算特定键的值，则执行后续操作，参数表示丢失的键，返回与键关联的值。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.createDefault⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
key	K	是	表示丢失的键。

返回值：

类型	说明
V	返回与键关联的值。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
let result = pro.createDefault(50);

entries^(deprecated)

entries(): IterableIterator<[K,V]>

允许迭代包含在这个对象中的所有键值对。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用LRUCache.entries⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
[K, V]	返回一个可迭代数组。

示例：

let pro : util.LruBuffer<number,number> = 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.iterator⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
[K, V]	返回一个键值对形式的二维数组。

示例：

let pro : util.LruBuffer<number,number> = new util.LruBuffer();
pro.put(2,10);
let result = pro[Symbol.iterator]();

Scope^(deprecated)

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper⁹⁺替代。

constructor^(deprecated)

constructor(lowerObj: ScopeType, upperObj: ScopeType)

用于创建指定下限和上限的作用域实例的构造函数，返回一个Scope对象。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.constructor⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
lowerObj	ScopeType	是	指定作用域实例的下限。
upperObj	ScopeType	是	指定作用域实例的上限。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}
let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
console.info("range = " + range);
// 输出结果：range = [30, 40]

toString^(deprecated)

toString(): string

该字符串化方法返回一个包含当前范围的字符串表示形式。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.toString⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
string	返回包含当前范围对象的字符串表示形式。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
let result = range.toString();
console.info("result = " + result);
// 输出结果：result = [30, 40]

intersect^(deprecated)

intersect(range: Scope): Scope

获取给定范围和当前范围的交集。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.intersect⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
range	Scope	是	传入一个给定范围。

返回值：

类型	说明
Scope	返回给定范围和当前范围的交集。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
let result = range.intersect(rangeFir );
console.info("result = " + result);
// 输出结果：result = [35, 39]

intersect^(deprecated)

intersect(lowerObj:ScopeType,upperObj:ScopeType):Scope

获取当前范围与给定下限和上限范围的交集。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.intersect⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
lowerObj	ScopeType	是	给定范围的下限。
upperObj	ScopeType	是	给定范围的上限。

返回值：

类型	说明
Scope	返回当前范围与给定下限和上限范围的交集。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = [35, 39]

getUpper^(deprecated)

getUpper(): ScopeType

获取当前范围的上限。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.getUpper⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
ScopeType	返回当前范围的上限值。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
let result = range.getUpper();
console.info("result = " + result);
// 输出结果：result = 40

getLower^(deprecated)

getLower(): ScopeType

获取当前范围的下限。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.getLower⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

返回值：

类型	说明
ScopeType	返回当前范围的下限值。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
let result = range.getLower();
console.info("result = " + result);
// 输出结果：result = 30

expand^(deprecated)

expand(lowerObj: ScopeType,upperObj: ScopeType): Scope

创建并返回包括当前范围和给定下限和上限的并集。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.expand⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
lowerObj	ScopeType	是	给定范围的下限。
upperObj	ScopeType	是	给定范围的上限。

返回值：

类型	说明
Scope	返回当前范围和给定下限和上限的并集。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = [30, 40]

expand^(deprecated)

expand(range: Scope): Scope

创建并返回包括当前范围和给定范围的并集。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.expand⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
range	Scope	是	传入一个给定范围。

返回值：

类型	说明
Scope	返回包括当前范围和给定范围的并集。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = [30, 40]

expand^(deprecated)

expand(value: ScopeType): Scope

创建并返回包括当前范围和给定值的并集。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.expand⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	ScopeType	是	传入一个给定值。

返回值：

类型	说明
Scope	返回包括当前范围和给定值的并集。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = [30, 40]

contains^(deprecated)

contains(value: ScopeType): boolean

检查给定value是否包含在当前范围内。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.contains⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	ScopeType	是	传入一个给定值。

返回值：

类型	说明
boolean	如果给定值包含在当前范围内返回true，否则返回false。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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.contains(tempMiDF);
console.info("result = " + result);
// 输出结果：result = true

contains^(deprecated)

contains(range: Scope): boolean

检查给定range是否在当前范围内。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.contains⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
range	Scope	是	传入一个给定范围。

返回值：

类型	说明
boolean	如果给定范围包含在当前范围内返回true，否则返回false。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = false

clamp^(deprecated)

clamp(value: ScopeType): ScopeType

将给定值限定到当前范围内。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.clamp⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
value	ScopeType	是	传入的给定值。

返回值：

类型	说明
ScopeType	如果传入的value小于下限，则返回lowerObj；如果大于上限值则返回upperObj；如果在当前范围内，则返回value。

示例：

class Temperature{
  private readonly _temp: number;
  constructor(value : number) {
    this._temp = value;
  }
  compareTo(value : Temperature ) {
    return this._temp >= value.getTemp();
  }
  getTemp() {
    return this._temp;
  }
  toString() : string {
    return this._temp.toString();
  }
}

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);
console.info("result = " + result);
// 输出结果：result = 35

Base64^(deprecated)

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper⁹⁺替代。

constructor^(deprecated)

constructor()

Base64的构造函数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.constructor⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

示例：

let base64 = new  util.Base64();

encodeSync^(deprecated)

encodeSync(src: Uint8Array): Uint8Array

通过输入参数编码后输出对应文本。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.encodeSync⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
src	Uint8Array	是	编码输入Uint8数组。

返回值：

类型	说明
Uint8Array	返回编码后新分配的Uint8数组。

示例：

let base64 = new util.Base64();
let array = new Uint8Array([115,49,51]);
let result = base64.encodeSync(array);
console.info("result = " + result);
// 输出结果：result = 99,122,69,122

encodeToStringSync^(deprecated)

encodeToStringSync(src: Uint8Array): string

通过输入参数编码后输出对应文本。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.encodeToStringSync⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
src	Uint8Array	是	编码输入Uint8数组。

返回值：

类型	说明
string	返回编码后的字符串。

示例：

let base64 = new util.Base64();
let array = new Uint8Array([115,49,51]);
let result = base64.encodeToStringSync(array);
console.info("result = " + result);
// 输出结果：result = czEz

decodeSync^(deprecated)

decodeSync(src: Uint8Array | string): Uint8Array

通过输入参数解码后输出对应文本。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.decodeSync⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
src	Uint8Array | string	是	解码输入Uint8数组或者字符串。

返回值：

类型	说明
Uint8Array	返回解码后新分配的Uint8数组。

示例：

let base64 = new util.Base64();
let buff = 'czEz';
let result = base64.decodeSync(buff);
console.info("result = " + result);
// 输出结果：result = 115,49,51

encode^(deprecated)

encode(src: Uint8Array): Promise<Uint8Array>

通过输入参数异步编码后输出对应文本。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.encode⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
src	Uint8Array	是	异步编码输入Uint8数组。

返回值：

类型	说明
Promise<Uint8Array>	返回异步编码后新分配的Uint8数组。

示例：

let base64 = new util.Base64();
let array = new Uint8Array([115,49,51]);
base64.encode(array).then((val) => {
  console.info(val.toString());
  // 输出结果：99,122,69,122
})

encodeToString^(deprecated)

encodeToString(src: Uint8Array): Promise<string>

通过输入参数异步编码后输出对应文本。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.encodeToString⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
src	Uint8Array	是	异步编码输入Uint8数组。

返回值：

类型	说明
Promise<string>	返回异步编码后的字符串。

示例：

let base64 = new util.Base64();
let array = new Uint8Array([115,49,51]);
base64.encodeToString(array).then((val) => {
    console.info(val);
    // 输出结果：czEz
})

decode^(deprecated)

decode(src: Uint8Array | string): Promise<Uint8Array>

通过输入参数异步解码后输出对应文本。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.decode⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

ArkTS版本： 该接口仅适用于ArkTS1.1。

参数：

参数名	类型	必填	说明
src	Uint8Array | string	是	异步解码输入Uint8数组或者字符串。

返回值：

类型	说明
Promise<Uint8Array>	返回异步解码后新分配的Uint8数组。

示例：

let base64 = new util.Base64();
let array = new Uint8Array([99,122,69,122]);
base64.decode(array).then((val) => {
  console.info(val.toString());
  // 输出结果：115,49,51
})