OpenHarmony语言基础类库【@ohos.util (util工具函数)】

最新推荐文章于 2024-06-05 21:30:44 发布
最新推荐文章于 2024-06-05 21:30:44 发布
阅读量1.1k 收藏 25
点赞数 19
分类专栏： 鸿蒙 文章标签： harmonyos 程序员 鸿蒙开发 OpenHarmony 鸿蒙 鸿蒙系统 编程开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/138191924
版权

@ohos.util (util工具函数)

该模块主要提供常用的工具函数，实现字符串编解码（[TextEncoder])，[TextDecoder]）、有理数运算（[RationalNumber8+]）、缓冲区管理（[LRUCache9+]）、范围判断（[ScopeHelper9+]）、Base64编解码（[Base64Helper9+]）、内置对象类型检查（[types8+]）等功能。

说明：

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

导入模块

import util from '@ohos.util';

鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

util.format9+

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

格式说明符：

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

示例：

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

util.errnoToString9+

errnoToString(errno: number): string

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let errnum = -1; // -1 : a system error number
let result = util.errnoToString(errnum);
console.log("result = " + result);

部分错误码及信息示例：

错误码信息
-1operation not permitted
-2no such file or directory
-3no such process
-4interrupted system call
-5i/o error
-11resource temporarily unavailable
-12not enough memory
-13permission denied
-100network is down

util.callbackWrapper

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

对异步函数进行回调化处理，回调中第一个参数将是拒绝原因（如果 Promise 已解决，则为 null），第二个参数将是已解决的值。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

async function fn() {
 return 'hello world';
}
let cb = util.callbackWrapper(fn);
cb(1, (err, ret) => {
 if (err) throw err;
 console.log(ret);
});

util.promisify9+

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

async function fn() {
  return 'hello world';
}
const addCall = util.promisify(util.callbackWrapper(fn));
(async () => {
  try {
    let res: string = await addCall();
    console.log(res);
  } catch (err) {
    console.log(err);
  }
})();

util.generateRandomUUID9+

generateRandomUUID(entropyCache?: boolean): string

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
entropyCacheboolean否是否使用已缓存的UUID， 默认true。

返回值：

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

示例：

let uuid = util.generateRandomUUID(true);
console.log("RFC 4122 Version 4 UUID:" + uuid);
// 输出：
// RFC 4122 Version 4 UUID:88368f2a-d5db-47d8-a05f-534fab0a0045

util.generateRandomBinaryUUID9+

generateRandomBinaryUUID(entropyCache?: boolean): Uint8Array

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
entropyCacheboolean否是否使用已缓存的UUID， 默认true。

返回值：

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

示例：

let uuid = util.generateRandomBinaryUUID(true);
console.log(JSON.stringify(uuid));
// 输出：
// 138,188,43,243,62,254,70,119,130,20,235,222,199,164,140,150

util.parseUUID9+

parseUUID(uuid: string): Uint8Array

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let uuid = util.parseUUID("84bdf796-66cc-4655-9b89-d6218d100f9c");
console.log(JSON.stringify(uuid));
// 输出：
// 132,189,247,150,102,204,70,85,155,137,214,33,141,16,15,156

util.printf(deprecated)

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

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

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用[util.format9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let res = util.printf("%s", "hello world!");
console.log(res);

util.getErrorString(deprecated)

getErrorString(errno: number): string

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

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用[util.errnoToString9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let errnum = -1; // -1 : a system error number
let result = util.getErrorString(errnum);
console.log("result = " + result);

util.promiseWrapper(deprecated)

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

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

说明：

此接口不可用，建议使用[util.promisify9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

TextDecoder

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

属性

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

名称类型可读可写说明
encodingstring是否编码格式。 - 支持格式：utf-8、ibm866、iso-8859-2、iso-8859-3、iso-8859-4、iso-8859-5、iso-8859-6、iso-8859-7、iso-8859-8、iso-8859-8-i、iso-8859-10、iso-8859-13、iso-8859-14、iso-8859-15、koi8-r、koi8-u、macintosh、windows-874、windows-1250、windows-1251、windows-1252、windows-1253、windows-1254、windows-1255、windows-1256、windows-1257、windows-1258、x-mac-cyrilli、gbk、gb18030、big5、euc-jp、iso-2022-jp、shift_jis、euc-kr、utf-16be、utf-16le。
fatalboolean是否是否显示致命错误。
ignoreBOMboolean是否是否忽略BOM（byte order marker）标记，默认值为false ，表示解码结果包含BOM标记。

constructor9+

constructor()

TextDecoder的构造函数。

系统能力：  SystemCapability.Utils.Lang

示例：

let result = new util.TextDecoder();
let retStr = result.encoding;

create9+

static create(encoding?: string,options?: { fatal?: boolean; ignoreBOM?: boolean }): TextDecoder

替代有参构造功能。

系统能力：  SystemCapability.Utils.Lang

参数：

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

表1.1options

名称参数类型必填说明
fatalboolean否是否显示致命错误，默认值是false。
ignoreBOMboolean否是否忽略BOM标记，默认值是false。

示例：

let result = util.TextDecoder.create('utf-8', { ignoreBOM : true })
let retStr = result.encoding

decodeWithStream9+

decodeWithStream(input: Uint8Array, options?: { stream?: boolean }): string

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

表2 options

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

返回值：

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

示例：

let textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true});
let result = new Uint8Array(6);
result[0] = 0xEF;
result[1] = 0xBB;
result[2] = 0xBF;
result[3] = 0x61;
result[4] = 0x62;
result[5] = 0x63;
console.log("input num:");
let retStr = textDecoder.decodeWithStream( result , {stream: false});
console.log("retStr = " + retStr);

constructor(deprecated)

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

TextDecoder的构造函数。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用[create9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

表1 options

名称参数类型必填说明
fatalboolean否是否显示致命错误，默认值是false。
ignoreBOMboolean否是否忽略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开始废弃，建议使用[decodeWithStream9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

表2 options

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

返回值：

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

示例：

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

TextEncoder

TextEncoder用于将字符串编码为字节数组，支持多种编码格式，包括utf-8、utf-16le/be等。需要注意的是，在使用TextEncoder进行编码时，不同编码格式下字符所占的字节数是不同的。例如，utf-8编码下中文字符通常占3个字节，而utf-16le/be编码下中文字符通常占2个字节。因此，在使用TextEncoder时需要明确指定要使用的编码格式，以确保编码结果正确。

属性

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

名称类型可读可写说明
encodingstring是否编码格式，默认值是'utf-8'。

constructor

constructor()

TextEncoder的构造函数。

系统能力：  SystemCapability.Utils.Lang

示例：

let textEncoder = new util.TextEncoder();

constructor9+

constructor(encoding?: string)

TextEncoder的构造函数。

系统能力：  SystemCapability.Utils.Lang

参数：

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

示例：

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

encodeInto9+

encodeInto(input?: string): Uint8Array

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let textEncoder = new util.TextEncoder();
let buffer = new ArrayBuffer(20);
let result = new Uint8Array(buffer);
result = textEncoder.encodeInto("\uD800¥¥");

encodeIntoUint8Array9+

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.TextEncoder()
let buffer = new ArrayBuffer(4)
let dest = new Uint8Array(buffer)
let result = new Object()
result = that.encodeIntoUint8Array('abcd', dest)

encodeInto(deprecated)

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

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

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用[encodeIntoUint8Array9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.TextEncoder()
let buffer = new ArrayBuffer(4)
let dest = new Uint8Array(buffer)
let result = new Object()
result = that.encodeInto('abcd', dest)

encode(deprecated)

encode(input?: string): Uint8Array

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

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用[encodeInto9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let textEncoder = new util.TextEncoder();
let buffer = new ArrayBuffer(20);
let result = new Uint8Array(buffer);
result = textEncoder.encode("\uD800¥¥");

RationalNumber8+

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

constructor9+

constructor()

RationalNumber的构造函数。

系统能力：  SystemCapability.Utils.Lang

示例：

let rationalNumber = new util.RationalNumber();

parseRationalNumber9+

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

替代原有参构造的参数处理。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
numeratornumber是分子，整数类型。
denominatornumber是分母，整数类型。

示例：

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

createRationalFromString8+

static createRationalFromString​(rationalString: string): RationalNumber​

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
object返回有理数类的对象。

示例：

let rationalNumber = new util.RationalNumber(1,2);
let rational = util.RationalNumber.createRationalFromString("3/4");

compare9+

compare​(another: RationalNumber): number​

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let rationalNumber = new util.RationalNumber(1,2);
let rational = util.RationalNumber.createRationalFromString("3/4");
let result = rationalNumber.compare(rational);

valueOf8+

valueOf(): number

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

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

equals8+

equals​(obj: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let rationalNumber = new util.RationalNumber(1,2);
let rational = util.RationalNumber.createRationalFromString("3/4");
let result = rationalNumber.equals(rational);

getCommonFactor9+

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
number1number是整数类型。
number2number是整数类型。

返回值：

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

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = util.RationalNumber.getCommonFactor(4,6);

getNumerator8+

getNumerator​(): number

获取当前RationalNumber对象的分子。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

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

getDenominator8+

getDenominator​(): number

获取当前RationalNumber对象的分母。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

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

isZero8+

isZero​():boolean

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

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

isNaN8+

isNaN​(): boolean

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

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

isFinite8+

isFinite​():boolean

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

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

toString8+

toString​(): string

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

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

constructor(deprecated)

constructor(numerator: number,denominator: number)

RationalNumber的构造函数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[constructor9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
numeratornumber是分子，整数类型。
denominatornumber是分母，整数类型。

示例：

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

compareTo(deprecated)

compareTo​(another: RationalNumber): number​

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[compare9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let rationalNumber = new util.RationalNumber(1,2);
let rational = util.RationalNumber.createRationalFromString("3/4");
let result = rationalNumber.compareTo(rational);

getCommonDivisor(deprecated)

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

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[getCommonFactor9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
number1number是整数类型。
number2number是整数类型。

返回值：

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

示例：

let rationalNumber = new util.RationalNumber(1,2);
let result = util.RationalNumber.getCommonDivisor(4,6);

LRUCache9+

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

属性

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

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
pro.put(1,8);
let result = pro.length;

constructor9+

constructor(capacity?: number)

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
capacitynumber否指示要为缓冲区自定义的容量。

示例：

let lrubuffer= new util.LRUCache();

updateCapacity9+

updateCapacity(newCapacity: number): void

将缓冲区容量更新为指定容量，如果newCapacity小于或等于0，则抛出异常。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
newCapacitynumber是指示要为缓冲区自定义的容量。

示例：

let pro = new util.LRUCache();
pro.updateCapacity(100);

toString9+

toString(): string

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

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

getCapacity9+

getCapacity(): number

获取当前缓冲区的容量。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LRUCache();
let result = pro.getCapacity();

clear9+

clear(): void

从当前缓冲区清除键值对。后续会调用afterRemoval()方法执行后续操作。

系统能力：  SystemCapability.Utils.Lang

示例：

let pro = new util.LRUCache();
pro.put(2,10);
let result = pro.length;
pro.clear();

getCreateCount9+

getCreateCount(): number

获取创建对象的次数。

系统能力：  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();

getMissCount9+

getMissCount(): number

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
pro.get(2);
let result = pro.getMissCount();

getRemovalCount9+

getRemovalCount(): number

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
pro.updateCapacity(2);
pro.put(50,22);
let result = pro.getRemovalCount();

getMatchCount9+

getMatchCount(): number

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
pro.get(2);
let result = pro.getMatchCount();

getPutCount9+

getPutCount(): number

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
let result = pro.getPutCount();

isEmpty9+

isEmpty(): boolean

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
let result = pro.isEmpty();

get9+

get(key: K): V | undefined

表示要查询的键。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
let result  = pro.get(2);

put9+

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

将键值对添加到缓冲区。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keyK是要添加的密钥。
valueV是指示与要添加的键关联的值。

返回值：

类型说明
V返回与添加的键关联的值；如果要添加的键已经存在，则返回原始值，如果键或值为空，则抛出此异常。

示例：

let pro = new util.LRUCache();
let result = pro.put(2,10);

values9+

values(): V[]

获取当前缓冲区中所有值从最近访问到最近最少访问的顺序列表 。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
pro.put(2,"anhu");
pro.put("afaf","grfb");
let result = pro.values();

keys9+

keys(): K[]

获取当前缓冲区中所有键从最近访问到最近最少访问的升序列表。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
let result = pro.keys();

remove9+

remove(key: K): V | undefined

从当前缓冲区中删除指定的键及其关联的值。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keyK是要删除的密钥。

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
let result = pro.remove(20);

afterRemoval9+

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

删除值后执行后续操作。

系统能力：  SystemCapability.Utils.Lang

参数：

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

示例：

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);
      console.info('value: ' + value);
      console.info('newValue: ' + newValue);
    }
  }
}
let lru: ChildLRUCache<number, number>= new ChildLRUCache(2);
lru.put(1, 1);
lru.put(2, 2);
lru.put(3, 3);

contains9+

contains(key: K): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let pro = new util.LRUCache();
pro.put(2,10);
let obj = {1:"key"};
let result = pro.contains(obj);

createDefault9+

createDefault(key: K): V

如果未计算特定键的值，则执行后续操作，参数表示丢失的键，返回与键关联的值。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keyK是表示丢失的键。

返回值：

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

示例：

let pro = new util.LRUCache();
let result = pro.createDefault(50);

entries9+

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

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro: util.LRUCache<number, number> = new util.LRUCache();
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.log(value[0]+ ', '+ value[1]);
}

[Symbol.iterator]9+

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

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro: util.LRUCache<number, number> = new util.LRUCache();
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.log(value[0]+ ', '+ value[1]);
}

ScopeComparable8+

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

系统能力：  SystemCapability.Utils.Lang

compareTo8+

compareTo(other: ScopeComparable): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

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

class Temperature{
    // 当使用ArkTS语言开发时，需要补充以下代码：
    // private readonly _temp: Temperature;
    constructor(value) {
       this._temp = value;
    }
    compareTo(value) {
       return this._temp >= value.getTemp();
    }
    getTemp() {
       return this._temp;
    }
    toString() {
       return this._temp.toString();
    }
}

ScopeType8+

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

系统能力：  SystemCapability.Utils.Lang

类型说明
number表示值的类型为数字。
[ScopeComparable]表示值的类型为ScopeComparable。

ScopeHelper9+

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

constructor9+

constructor(lowerObj: ScopeType, upperObj: ScopeType)

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);

toString9+

toString(): string

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

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.toString();

intersect9+

intersect(range: ScopeHelper): ScopeHelper

获取给定范围和当前范围的交集。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
let tempMiDF = new Temperature(35);
let tempMidS = new Temperature(39);
let rangeFir = new util.ScopeHelper(tempMiDF, tempMidS);
range.intersect(rangeFir);

intersect9+

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let tempMidS = new Temperature(39);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.intersect(tempMiDF, tempMidS);

getUpper9+

getUpper(): ScopeType

获取当前范围的上限。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.getUpper();

getLower9+

getLower(): ScopeType

获取当前范围的下限。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.getLower();

expand9+

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let tempMidS = new Temperature(39);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.expand(tempMiDF, tempMidS);

expand9+

expand(range: ScopeHelper): ScopeHelper

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let tempMidS = new Temperature(39);
let range = new util.ScopeHelper(tempLower, tempUpper);
let rangeFir = new util.ScopeHelper(tempMiDF, tempMidS);
let result = range.expand(rangeFir);

expand9+

expand(value: ScopeType): ScopeHelper

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.expand(tempMiDF);

contains9+

contains(value: ScopeType): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.contains(tempMiDF);

contains9+

contains(range: ScopeHelper): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.ScopeHelper(tempLower, tempUpper);
let tempLess = new Temperature(20);
let tempMore = new Temperature(45);
let rangeSec = new util.ScopeHelper(tempLess, tempMore);
let result = range.contains(rangeSec);

clamp9+

clamp(value: ScopeType): ScopeType

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let range = new util.ScopeHelper(tempLower, tempUpper);
let result = range.clamp(tempMiDF);

Base64Helper9+

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

constructor9+

constructor()

Base64Helper的构造函数。

系统能力：  SystemCapability.Utils.Lang

示例：

let base64 = new  util.Base64Helper();

encodeSync9+

encodeSync(src: Uint8Array): Uint8Array

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Array是编码输入Uint8数组。

返回值：

类型说明
Uint8Array返回编码后新分配的Uint8数组。

示例：

let that = new util.Base64Helper();
let array = new Uint8Array([115,49,51]);
let result = that.encodeSync(array);

encodeToStringSync9+

encodeToStringSync(src: Uint8Array): string

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Array是编码输入Uint8数组。

返回值：

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

示例：

let that = new util.Base64Helper();
let array = new Uint8Array([115,49,51]);
let result = that.encodeToStringSync(array);

decodeSync9+

decodeSync(src: Uint8Array | string): Uint8Array

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Arraystring是解码输入Uint8数组或者字符串。

返回值：

类型说明
Uint8Array返回解码后新分配的Uint8数组。

示例：

let that = new util.Base64Helper();
let buff = 'czEz';
let result = that.decodeSync(buff);

encode9+

encode(src: Uint8Array): Promise<Uint8Array>

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Array是异步编码输入Uint8数组。

返回值：

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

示例：

let that = new util.Base64Helper();
let array = new Uint8Array([115,49,51]);
let rarray = new Uint8Array([99,122,69,122]);
that.encode(array).then(val=>{    
  for (var i = 0; i < rarray.length; i++) {        
      console.log(val[i].toString())
  }
})

encodeToString9+

encodeToString(src: Uint8Array): Promise<string>

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Array是异步编码输入Uint8数组。

返回值：

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

示例：

let that = new util.Base64Helper();
let array = new Uint8Array([115,49,51]);
that.encodeToString(array).then(val=>{    
  console.log(val)
})

decode9+

decode(src: Uint8Array | string): Promise<Uint8Array>

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

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Arraystring是异步解码输入Uint8数组或者字符串。

返回值：

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

示例：

let that = new util.Base64Helper();
let array = new Uint8Array([99,122,69,122]);
let rarray = new Uint8Array([115,49,51]);
that.decode(array).then(val=>{    
  for (var i = 0; i < rarray.length; i++) {        
      console.log(val[i].toString())
  }
})

types8+

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

constructor8+

constructor()

Types的构造函数。

系统能力：  SystemCapability.Utils.Lang

示例：

let type = new util.types();

isAnyArrayBuffer8+

isAnyArrayBuffer(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isAnyArrayBuffer(new ArrayBuffer(0));

isArrayBufferView8+

isArrayBufferView(value: Object): boolean

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isArrayBufferView(new Int8Array([]));

isArgumentsObject8+

isArgumentsObject(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
function foo() {
    var result = that.isArgumentsObject(arguments);
}
let f = foo();

isArrayBuffer8+

isArrayBuffer(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isArrayBuffer(new ArrayBuffer(0));

isAsyncFunction8+

isAsyncFunction(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isAsyncFunction(async function foo() {});

isBooleanObject8+

isBooleanObject(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isBooleanObject(new Boolean(true));

isBoxedPrimitive8+

isBoxedPrimitive(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isBoxedPrimitive(new Boolean(false));

isDataView8+

isDataView(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
const ab = new ArrayBuffer(20);
let result = that.isDataView(new DataView(ab));

isDate8+

isDate(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isDate(new Date());

isExternal8+

isExternal(value: Object): boolean

检查输入的value是否是native External类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isExternal(true);

isFloat32Array8+

isFloat32Array(value: Object): boolean

检查输入的value是否是Float32Array数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isFloat32Array(new Float32Array());

isFloat64Array8+

isFloat64Array(value: Object): boolean

检查输入的value是否是Float64Array数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isFloat64Array(new Float64Array());

isGeneratorFunction8+

isGeneratorFunction(value: Object): boolean

检查输入的value是否是generator函数类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isGeneratorFunction(function* foo() {});

isGeneratorObject8+

isGeneratorObject(value: Object): boolean

检查输入的value是否是generator对象类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
function* foo() {}
const generator = foo();
let result = that.isGeneratorObject(generator);

isInt8Array8+

isInt8Array(value: Object): boolean

检查输入的value是否是Int8Array数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isInt8Array(new Int8Array([]));

isInt16Array8+

isInt16Array(value: Object): boolean

检查输入的value是否是Int16Array数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isInt16Array(new Int16Array([]));

isInt32Array8+

isInt32Array(value: Object): boolean

检查输入的value是否是Int32Array数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isInt32Array(new Int32Array([]));

isMap8+

isMap(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isMap(new Map());

isMapIterator8+

isMapIterator(value: Object): boolean

检查输入的value是否是Map的Iterator类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
const map = new Map();
let result = that.isMapIterator(map.keys());

isNativeError8+

isNativeError(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isNativeError(new TypeError());

isNumberObject8+

isNumberObject(value: Object): boolean

检查输入的value是否是Number对象类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isNumberObject(new Number(0));

isPromise8+

isPromise(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isPromise(Promise.resolve(1));

isProxy8+

isProxy(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
const target = {};
const proxy = new Proxy(target, {});
let result = that.isProxy(proxy);

isRegExp8+

isRegExp(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isRegExp(new RegExp('abc'));

isSet8+

isSet(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isSet(new Set());

isSetIterator8+

isSetIterator(value: Object): boolean

检查输入的value是否是Set的Iterator类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
const set = new Set();
let result = that.isSetIterator(set.keys());

isStringObject8+

isStringObject(value: Object): boolean

检查输入的value是否是String对象类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isStringObject(new String('foo'));

isSymbolObjec8+

isSymbolObject(value: Object): boolean

检查输入的value是否是Symbol对象类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
const symbols = Symbol('foo');
let result = that.isSymbolObject(Object(symbols));

isTypedArray8+

isTypedArray(value: Object): boolean

检查输入的value是否是TypedArray类型的辅助类型。

TypedArray类型的辅助类型，包括Int8Array、Int16Array、Int32Array、Uint8Array、Uint8ClampedArray、Uint16Array、Uint32Array、Float32Array、Float64Array、DataView。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isTypedArray(new Float64Array([]));

isUint8Array8+

isUint8Array(value: Object): boolean

检查输入的value是否是Uint8Array数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isUint8Array(new Uint8Array([]));

isUint8ClampedArray8+

isUint8ClampedArray(value: Object): boolean

检查输入的value是否是Uint8ClampedArray数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isUint8ClampedArray(new Uint8ClampedArray([]));

[](zh-cn/application-dev/reference/apis/js-apis-util.md · OpenHarmony/docs - Gitee.com)isUint16Array8+

isUint16Array(value: Object): boolean

检查输入的value是否是Uint16Array数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isUint16Array(new Uint16Array([]));

isUint32Array8+

isUint32Array(value: Object): boolean

检查输入的value是否是Uint32Array数组类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isUint32Array(new Uint32Array([]));

isWeakMap8+

isWeakMap(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isWeakMap(new WeakMap());

isWeakSet8+

isWeakSet(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isWeakSet(new WeakSet());

isBigInt64Array8+

isBigInt64Array(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isBigInt64Array(new BigInt64Array([]));

isBigUint64Array8+

isBigUint64Array(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isBigUint64Array(new BigUint64Array([]));

isModuleNamespaceObject8+

isModuleNamespaceObject(value: Object): boolean

检查输入的value是否是Module Namespace Object类型。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

import url from '@ohos.url'
let that = new util.types();
let result = that.isModuleNamespaceObject(url);

isSharedArrayBuffer8+

isSharedArrayBuffer(value: Object): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let that = new util.types();
let result = that.isSharedArrayBuffer(new SharedArrayBuffer(0));

LruBuffer(deprecated)

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache9+]替代。

属性

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

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
pro.put(1,8);
let result = pro.length;

constructor(deprecated)

constructor(capacity?: number)

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.constructor9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
capacitynumber否指示要为缓冲区自定义的容量。

示例：

let lrubuffer= new util.LruBuffer();

updateCapacity(deprecated)

updateCapacity(newCapacity: number): void

将缓冲区容量更新为指定容量，如果newCapacity小于或等于0，则抛出异常。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.updateCapacity9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
newCapacitynumber是指示要为缓冲区自定义的容量。

示例：

let pro = new util.LruBuffer();
pro.updateCapacity(100);

toString(deprecated)

toString(): string

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.toString9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
pro.remove(20);
let result = pro.toString();

getCapacity(deprecated)

getCapacity(): number

获取当前缓冲区的容量。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getCapacity9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
let result = pro.getCapacity();

clear(deprecated)

clear(): void

从当前缓冲区清除键值对。后续会调用afterRemoval()方法执行后续操作。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.clear9+]替代。

系统能力：  SystemCapability.Utils.Lang

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result = pro.length;
pro.clear();

getCreateCount(deprecated)

getCreateCount(): number

获取createDefault()返回值的次数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getCreateCount9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

类型说明
number返回createDefault()返回值的次数。

示例：

let pro = new util.LruBuffer();
pro.put(1,8);
let result = pro.getCreateCount();

getMissCount(deprecated)

getMissCount(): number

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getMissCount9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
let result = pro.getMissCount();

getRemovalCount(deprecated)

getRemovalCount(): number

获取从缓冲区中逐出值的次数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getRemovalCount9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

类型说明
number返回从缓冲区中驱逐的次数。

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
pro.updateCapacity(2);
pro.put(50,22);
let result = pro.getRemovalCount();

getMatchCount(deprecated)

getMatchCount(): number

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getMatchCount9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
let result = pro.getMatchCount();

getPutCount(deprecated)

getPutCount(): number

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.getPutCount9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result = pro.getPutCount();

isEmpty(deprecated)

isEmpty(): boolean

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.isEmpty9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result = pro.isEmpty();

get(deprecated)

get(key: K): V | undefined

表示要查询的键。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.get9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result  = pro.get(2);

put(deprecated)

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

将键值对添加到缓冲区。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.put9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keyK是要添加的密钥。
valueV是指示与要添加的键关联的值。

返回值：

类型说明
V返回与添加的键关联的值；如果要添加的键已经存在，则返回原始值，如果键或值为空，则抛出此异常。

示例：

let pro = new util.LruBuffer();
let result = pro.put(2,10);

values(deprecated)

values(): V[]

获取当前缓冲区中所有值从最近访问到最近最少访问的顺序列表。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.values9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
pro.put(2,"anhu");
pro.put("afaf","grfb");
let result = pro.values();

keys(deprecated)

keys(): K[]

获取当前缓冲区中所有键从最近访问到最近最少访问的升序列表。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.keys9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result = pro.keys();

remove(deprecated)

remove(key: K): V | undefined

从当前缓冲区中删除指定的键及其关联的值。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.remove9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keyK是要删除的密钥。

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result = pro.remove(20);

afterRemoval(deprecated)

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

删除值后执行后续操作。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.afterRemoval9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
isEvictboolean是因容量不足而调用该方法时，参数值为true，其他情况为false。
keyK是表示删除的键。
valueV是表示删除的值。
newValueV是如果已调用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);
      console.info('value: ' + value);
      console.info('newValue: ' + newValue);
    }
  }
}
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.contains9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result = pro.contains(20);

createDefault(deprecated)

createDefault(key: K): V

如果未计算特定键的值，则执行后续操作，参数表示丢失的键，返回与键关联的值。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.createDefault9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keyK是表示丢失的键。

返回值：

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

示例：

let pro = new util.LruBuffer();
let result = pro.createDefault(50);

entries(deprecated)

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

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.entries9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result = pro.entries();

Symbol.iterator

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

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[LRUCache.Symbol.iterator9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let pro = new util.LruBuffer();
pro.put(2,10);
let result = pro[Symbol.iterator]();

Scope(deprecated)

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper9+]替代。

constructor(deprecated)

constructor(lowerObj: ScopeType, upperObj: ScopeType)

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.constructor9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);

toString(deprecated)

toString(): string

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.toString9+]替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
let result = range.toString();

intersect(deprecated)

intersect(range: Scope): Scope

获取给定范围和当前范围的交集。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.intersect9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
range[Scope]()是传入一个给定范围。

返回值：

类型说明
[Scope]()返回给定范围和当前范围的交集。

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
let tempMiDF = new Temperature(35);
let tempMidS = new Temperature(39);
let rangeFir = new util.Scope(tempMiDF, tempMidS);
range.intersect(rangeFir );

intersect(deprecated)

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

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用[ScopeHelper.intersect9+]替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
[Scope]()返回当前范围与给定下限和上限范围的交集。

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let tempMidS = new Temperature(39);
let range = new util.Scope(tempLower, tempUpper);
let result = range.intersect(tempMiDF, tempMidS);

getUpper(deprecated)

getUpper(): ScopeType

获取当前范围的上限。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.getUpper9+替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
let result = range.getUpper();

getLower(deprecated)

getLower(): ScopeType

获取当前范围的下限。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.getLower9+替代。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
let result = range.getLower();

expand(deprecated)

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

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.expand9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
lowerObjScopeType是给定范围的下限。
upperObjScopeType是给定范围的上限。

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let tempMidS = new Temperature(39);
let range = new util.Scope(tempLower, tempUpper);
let result = range.expand(tempMiDF, tempMidS);

expand(deprecated)

expand(range: Scope): Scope

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.expand9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let tempMidS = new Temperature(39);
let range = new util.Scope(tempLower, tempUpper);
let rangeFir = new util.Scope(tempMiDF, tempMidS);
let result = range.expand(rangeFir);

expand(deprecated)

expand(value: ScopeType): Scope

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.expand9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let range = new util.Scope(tempLower, tempUpper);
let result = range.expand(tempMiDF);

contains(deprecated)

contains(value: ScopeType): boolean

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.contains9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let range = new util.Scope(tempLower, tempUpper);
range.contains(tempMiDF);

contains(deprecated)

contains(range: Scope): boolean

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.contains9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let range = new util.Scope(tempLower, tempUpper);
let tempLess = new Temperature(20);
let tempMore = new Temperature(45);
let rangeSec = new util.Scope(tempLess, tempMore);
let result = range.contains(rangeSec);

clamp(deprecated)

clamp(value: ScopeType): ScopeType

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用ScopeHelper.clamp9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let tempLower = new Temperature(30);
let tempUpper = new Temperature(40);
let tempMiDF = new Temperature(35);
let range = new util.Scope(tempLower, tempUpper);
let result = range.clamp(tempMiDF);

Base64(deprecated)

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper9+替代。

constructor(deprecated)

constructor()

Base64的构造函数。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.constructor9+替代。

系统能力：  SystemCapability.Utils.Lang

示例：

let base64 = new  util.Base64();

encodeSync(deprecated)

encodeSync(src: Uint8Array): Uint8Array

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.encodeSync9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Array是编码输入Uint8数组。

返回值：

类型说明
Uint8Array返回编码后新分配的Uint8数组。

示例：

let that = new util.Base64();
let array = new Uint8Array([115,49,51]);
let result = that.encodeSync(array);

encodeToStringSync(deprecated)

encodeToStringSync(src: Uint8Array): string

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.encodeToStringSync9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Array是编码输入Uint8数组。

返回值：

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

示例：

let that = new util.Base64();
let array = new Uint8Array([115,49,51]);
let result = that.encodeToStringSync(array);

decodeSync(deprecated)

decodeSync(src: Uint8Array | string): Uint8Array

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.decodeSync9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Arraystring是解码输入Uint8数组或者字符串。

返回值：

类型说明
Uint8Array返回解码后新分配的Uint8数组。

示例：

let that = new util.Base64();
let buff = 'czEz';
let result = that.decodeSync(buff);

encode(deprecated)

encode(src: Uint8Array): Promise<Uint8Array>

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.encode9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Array是异步编码输入Uint8数组。

返回值：

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

示例：

let that = new util.Base64();
let array = new Uint8Array([115,49,51]);
let rarray = new Uint8Array([99,122,69,122]);
that.encode(array).then(val=>{    
    for (var i = 0; i < rarray.length; i++) {        
        console.log(val[i].toString())
    }
})

encodeToString(deprecated)

encodeToString(src: Uint8Array): Promise<string>

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.encodeToString9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Array是异步编码输入Uint8数组。

返回值：

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

示例：

let that = new util.Base64();
let array = new Uint8Array([115,49,51]);
that.encodeToString(array).then(val=>{    
    console.log(val)
})

HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

搜狗高速浏览器截图20240326151450.png

decode(deprecated)

decode(src: Uint8Array | string): Promise<Uint8Array>

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

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用Base64Helper.decode9+替代。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
srcUint8Arraystring是异步解码输入Uint8数组或者字符串。

返回值：

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

示例：

let that = new util.Base64();
let array = new Uint8Array([99,122,69,122]);
let rarray = new Uint8Array([115,49,51]);
that.decode(array).then(val=>{    
    for (var i = 0; i < rarray.length; i++) {        
        console.log(val[i].toString())
    }
})

鸿蒙开发岗位需要掌握那些核心要领？

目前还有很多小伙伴不知道要学习哪些鸿蒙技术？不知道重点掌握哪些？为了避免学习时频繁踩坑，最终浪费大量时间的。

自己学习时必须要有一份实用的鸿蒙（Harmony NEXT）资料非常有必要。 这里我推荐，根据鸿蒙开发官网梳理与华为内部人员的分享总结出的开发文档。内容包含了：【ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战】等技术知识点。

废话就不多说了，接下来好好看下这份资料。

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。鸿蒙OpenHarmony知识←前往。下面是鸿蒙开发的学习路线图。

针对鸿蒙成长路线打造的鸿蒙学习文档。鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，帮助大家在技术的道路上更进一步。

其中内容包含：

《鸿蒙开发基础》鸿蒙OpenHarmony知识←前往

  1. ArkTS语言
  2. 安装DevEco Studio
  3. 运用你的第一个ArkTS应用
  4. ArkUI声明式UI开发
  5. .……

《鸿蒙开发进阶》鸿蒙OpenHarmony知识←前往

  1. Stage模型入门
  2. 网络管理
  3. 数据管理
  4. 电话服务
  5. 分布式应用开发
  6. 通知与窗口管理
  7. 多媒体技术
  8. 安全技能
  9. 任务管理
  10. WebGL
  11. 国际化开发
  12. 应用测试
  13. DFX面向未来设计
  14. 鸿蒙系统移植和裁剪定制
  15. ……

《鸿蒙开发实战》鸿蒙OpenHarmony知识←前往

  1. ArkTS实践
  2. UIAbility应用
  3. 网络案例
  4. ……

最后

鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！

爱桥代码的程序媛
关注
  • 19
    点赞
  • 踩
  • 25
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Java工具类库Hutool-v5.8.27.zip
04-27
Hutool工具包是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。 Hutool中的工具方法来自于每个用户的精雕细琢，...
hutool-all-5.8.4.jar
07-28
Hutool是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。 Hutool中的工具方法来自每个用户的精雕细琢，它涵盖了...
【HarmonyOS NEXT】如何生成UUID
Mayism123的博客
04-12 280
调用util.generateRandomBinaryUUID(entropyCache?: boolean)接口，可以使用加密安全随机数生成器生成随机的RFC 4122版本4的Uint8Array类型UUID。调用util.generateRandomUUID(entropyCache?: boolean)接口，可以使用加密安全随机数生成器生成随机的RFC 4122版本4的string类型UUID。接口请求需要传入参数UUID，如何生成UUID？生成UUID / @ohos.util。
OpenHarmony语言基础类库【@ohos.util.Stack (线性容器Stack)】
2301_76813281的博客
04-27 799
Stack基于数组的数据结构实现，特点是先进后出，只能在一端进行数据的插入和删除。Stack和[Queue]相比，Queue基于循环队列实现，只能在一端删除，另一端插入，而Stack都在一端操作。一般符合先进后出的场景可以使用Stack。文档中存在泛型的使用，涉及以下泛型标记符：T：Type，类。
OpenHarmony语言基础类库【@ohos.util.HashSet (非线性容器HashSet)】
2301_76813281的博客
04-26 1051
鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！
OpenHarmony语言基础类库【@ohos.util.Queue (线性容器Queue)】
2301_76813281的博客
04-27 846
鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！
OpenHarmony语言基础类库【@ohos.util.Deque (线性容器Deque)】
2301_76813281的博客
04-25 986
鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！
OpenHarmony语言基础类库【@ohos.util.List (线性容器List)】
2301_76813281的博客
04-27 903
而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点。
OpenHarmony语言基础类库【@ohos.util.HashMap (非线性容器HashMap)】
2301_76813281的博客
04-25 1017
HashMap底层使用数组+链表+红黑树的方式实现，查询、插入和删除的效率都很高。HashMap存储内容基于key-value的键值对映射，不能有重复的key，且一个key只能对应一个value。HashMap和[TreeMap]相比，HashMap依据键的hashCode存取数据，访问速度较快。而TreeMap是有序存取，效率较低。[HashSet]基于HashMap实现。HashMap的输入参数由key、value两个值组成。在HashSet中，只对value对象进行处理。
OpenHarmony语言基础类库【@ohos.util.TreeSet (非线性容器TreeSet)】
2301_76813281的博客
04-28 1282
TreeSet基于[TreeMap]实现，在TreeSet中，只对value对象进行处理。TreeSet可用于存储一系列值的集合，元素中value唯一且有序。TreeSet和[HashSet]相比，HashSet中的数据无序存放，而TreeSet是有序存放。它们集合中的元素都不允许重复，但HashSet允许放入null值，TreeSet不建议存放null值，可能会对排序结果产生影响。一般需要存储有序集合的场景，可以使用TreeSet。本模块首批接口从API version 8开始支持。
Hutool Java工具类库 v5.5.1
12-16
为您提供Hutool Java工具类库下载，Hutool是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”。Hutool中的工具方法...
小而全的Java工具类库，使Java拥有函数式语言般的优雅，让Java语言也可以“甜甜的”
05-22
hutool-core 核心，包括Bean操作、日期、各种Util等 hutool-cron 定时任务模块，提供类Crontab表达式的定时任务 hutool-crypto 加密解密模块，提供对称、非对称和摘要算法封装 hutool-db JDBC封装后的数据操作，基于...
hutool:一组使Java保持良好状态的工具
03-17
简介Hutool是一个小而全的Java工具类库，通过静态方法封装，降低相关API的学习成本，提高工作效率，使Java具有函数式语言般的优雅，让Java语言也可以“甜甜的”。 Hutool中的工具方法来自每个用户的精雕细琢，它涵盖...
鸿蒙轻内核M核源码分析系列六 任务及任务调度（3）任务调度模块
最新发布
maniuT的博客
06-05 593
调度，Schedule也称为Dispatch，是操作系统的一个重要模块，它负责选择系统要处理的下一个任务。调度模块需要协调处于就绪状态的任务对资源的竞争，按优先级策略从就绪队列中获取高优先级的任务，给予资源使用权。本文我们来一起学习下调度模块的源代码，文中所涉及的源代码，所涉及的源码，以内核为例，均可以在开源站点 https://gitee.com/openharmony/kernel_liteos_m 获取。下面，我们剖析下任务调度模块的源代码，若涉及开发板部分，以开发板工程为例进行源码分析。
在鸿蒙中身份校验的手势密码的实现
Asia52的博客
05-31 308
在harmony中它提供了默认的组件PatternLock()；.onPatternComplete：密码输入结束时触发该回调。.onDotConnect密码输入选中宫格圆点时触发该回调。这个就能直接显示九宫格密码验证。并且他有两个主要的回调事件。
鸿蒙工程目录介绍
shinecjj的博客
05-30 644
鸿蒙项目目录
装饰器，状态管理和if判断（HarmonyOS学习第六课）
qq_58213084的博客
06-02 1043
语法的定义使用方法全局的自定义构建函数可以被整个应用获取，不允许使用this和bind方法。如果不涉及组件状态变化，建议使用全局的自定义构建方法在前文的描述中，我们构建的页面多为静态界面。如果希望构建一个动态的、有交互的界面，就需要引入“状态”的概念在本章节开始的案例中，用户与应用程序的交互触发了文本状态变更，状态变更引起了UI 渲染，UI 从“Hello world”变更为“Hello rkUI”，这个过程就用到了状态。
Java中数组、字符串处理、例外及基础类库讲述了什么
05-29
Java中的数组、字符串处理、异常处理和基础类库是Java编程中非常重要的概念和技术，下面分别进行介绍： 1. 数组：Java中的数组是一种数据结构，用于存储一组相同类型的数据。数组在Java中是一个对象，可以动态创建和销毁。Java数组的下标从0开始，可以通过数组下标访问数组中的元素。数组操作是Java编程中最基本的操作之一，是各种数据结构和算法的基础。 2. 字符串处理：Java中的字符串是一种常用的数据类型，用于表示一组字符序列。Java中的字符串是不可变的，也就是说，一旦创建了一个字符串对象，就不能再修改它。Java提供了丰富的字符串处理函数，包括字符串拼接、字符串比较、子字符串查找等等。 3. 异常处理：Java中的异常处理机制用于处理程序运行中发生的异常情况。Java中的异常分为编译时异常和运行时异常两种。编译时异常在编译时就会被检查出来，需要在代码中显式地处理；运行时异常是程序运行时发生的异常，可以不用显式地处理。Java中的异常处理机制包括try-catch语句块、throws关键字等。 4. 基础类库：Java中的基础类库是Java标准库的一部分，包含了Java编程中常用的类和接口。Java中的基础类库包括java.lang、java.util、java.io等包，提供了丰富的数据类型、数据结构、输入输出、时间日期、网络编程等功能。Java中的基础类库是Java编程中不可或缺的一部分，需要程序员熟练掌握。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值