@ohos.util (util工具函数)

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

说明：

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

导入模块

import util from '@ohos.util';

util.format⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

util.errnoToString⁹⁺

errnoToString(errno: number): string

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

部分错误码及信息示例：

util.callbackWrapper

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

util.promisify⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

function fun(num, callback) {
 if (typeof num === 'number') {
    callback(null, num + 3);
 } else {
    callback("type err");
 }
}

const addCall = util.promisify(fun);
(async () => {
 try {
    let res = await addCall(2);
    console.log(res);
 } catch (err) {
    console.log(err);
 }
})();

util.generateRandomUUID⁹⁺

generateRandomUUID(entropyCache?: boolean): string

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

util.generateRandomBinaryUUID⁹⁺

generateRandomBinaryUUID(entropyCache?: boolean): Uint8Array

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.parseUUID⁹⁺

parseUUID(uuid: string): Uint8Array

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.format⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

util.getErrorString^(deprecated)

getErrorString(errno: number): string

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

说明：

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.promisify⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

TextDecoder

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

属性

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

constructor⁹⁺

constructor()

TextDecoder的构造函数。

系统能力： SystemCapability.Utils.Lang

create⁹⁺

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

替代有参构造功能。

系统能力： SystemCapability.Utils.Lang

参数：

表1.1options

示例：

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

decodeWithStream⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

参数：

表2 options

返回值：

示例：

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开始废弃，建议使用create⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

表1 options

示例：

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

decode^(deprecated)

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

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

说明：

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

系统能力： SystemCapability.Utils.Lang

参数：

表2 options

返回值：

示例：

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。

constructor

constructor()

TextEncoder的构造函数。

系统能力： SystemCapability.Utils.Lang

示例：

let textEncoder = new util.TextEncoder();

constructor⁹⁺

constructor(encoding?: string)

TextEncoder的构造函数。

系统能力： SystemCapability.Utils.Lang

参数：

示例：

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

encodeInto⁹⁺

encodeInto(input?: string): Uint8Array

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

encodeIntoUint8Array⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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开始废弃，建议使用encodeIntoUint8Array⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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开始废弃，建议使用encodeInto⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

RationalNumber⁸⁺

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

constructor⁹⁺

constructor()

RationalNumber的构造函数。

系统能力： SystemCapability.Utils.Lang

示例：

let rationalNumber = new util.RationalNumber();

parseRationalNumber⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

参数：

示例：

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

createRationalFromString⁸⁺

static createRationalFromString​(rationalString: string): RationalNumber​

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

compare⁹⁺

compare​(another: RationalNumber): number​

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

valueOf⁸⁺

valueOf(): number

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

equals⁸⁺

equals​(obj: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

getCommonFactor⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

getNumerator⁸⁺

getNumerator​(): number

获取当前RationalNumber对象的分子。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getDenominator⁸⁺

getDenominator​(): number

获取当前RationalNumber对象的分母。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

isZero⁸⁺

isZero​():boolean

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

isNaN⁸⁺

isNaN​(): boolean

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

isFinite⁸⁺

isFinite​():boolean

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

toString⁸⁺

toString​(): string

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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开始废弃，建议使用constructor⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

示例：

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

compareTo^(deprecated)

compareTo​(another: RationalNumber): number​

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

说明：

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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开始废弃，建议使用getCommonFactor⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

LRUCache⁹⁺

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

属性

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

示例：

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

constructor⁹⁺

constructor(capacity?: number)

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

系统能力： SystemCapability.Utils.Lang

参数：

示例：

let lrubuffer= new util.LRUCache();

updateCapacity⁹⁺

updateCapacity(newCapacity: number): void

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

系统能力： SystemCapability.Utils.Lang

参数：

示例：

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

toString⁹⁺

toString(): string

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getCapacity⁹⁺

getCapacity(): number

获取当前缓冲区的容量。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

clear⁹⁺

clear(): void

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

系统能力： SystemCapability.Utils.Lang

示例：

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

getCreateCount⁹⁺

getCreateCount(): number

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getMissCount⁹⁺

getMissCount(): number

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getRemovalCount⁹⁺

getRemovalCount(): number

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getMatchCount⁹⁺

getMatchCount(): number

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getPutCount⁹⁺

getPutCount(): number

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

isEmpty⁹⁺

isEmpty(): boolean

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

get⁹⁺

get(key: K): V | undefined

表示要查询的键。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

put⁹⁺

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

将键值对添加到缓冲区。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

values⁹⁺

values(): V[]

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

keys⁹⁺

keys(): K[]

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

remove⁹⁺

remove(key: K): V | undefined

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

afterRemoval⁹⁺

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

删除值后执行后续操作。

系统能力： SystemCapability.Utils.Lang

参数：

示例：

let arr = [];
class ChildLruBuffer<K, V> extends util.LRUCache<K, V>
{
  constructor()
  {
  	super();
  }
  afterRemoval(isEvict, key, value, newValue)
  {
  	if (isEvict === false)
  	{
  		arr = [key, value, newValue];
  	}
  }
}
let lru = new ChildLruBuffer();
lru.afterRemoval(false,10,30,null);

contains⁹⁺

contains(key: K): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

createDefault⁹⁺

createDefault(key: K): V

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

entries⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

[Symbol.iterator]⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

ScopeComparable⁸⁺

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

系统能力： SystemCapability.Utils.Lang

compareTo⁸⁺

compareTo(other: ScopeComparable): boolean;

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

构造新类，实现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();
    }
}

ScopeType⁸⁺

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

系统能力： SystemCapability.Utils.Lang

ScopeHelper⁹⁺

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

constructor⁹⁺

constructor(lowerObj: ScopeType, upperObj: ScopeType)

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

系统能力： SystemCapability.Utils.Lang

参数：

示例：

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

toString⁹⁺

toString(): string

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

intersect⁹⁺

intersect(range: ScopeHelper): ScopeHelper

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

getUpper⁹⁺

getUpper(): ScopeType

获取当前范围的上限。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getLower⁹⁺

getLower(): ScopeType

获取当前范围的下限。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

expand⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

expand⁹⁺

expand(range: ScopeHelper): ScopeHelper

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

expand⁹⁺

expand(value: ScopeType): ScopeHelper

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

contains⁹⁺

contains(value: ScopeType): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

contains⁹⁺

contains(range: ScopeHelper): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

clamp⁹⁺

clamp(value: ScopeType): ScopeType

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

Base64Helper⁹⁺

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

constructor⁹⁺

constructor()

Base64Helper的构造函数。

系统能力： SystemCapability.Utils.Lang

示例：

let base64 = new  util.Base64Helper();

encodeSync⁹⁺

encodeSync(src: Uint8Array): Uint8Array

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

encodeToStringSync⁹⁺

encodeToStringSync(src: Uint8Array): string

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

decodeSync⁹⁺

decodeSync(src: Uint8Array | string): Uint8Array

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

encode⁹⁺

encode(src: Uint8Array): Promise<Uint8Array>

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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())
  }
})

encodeToString⁹⁺

encodeToString(src: Uint8Array): Promise<string>

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

decode⁹⁺

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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())
  }
})

types⁸⁺

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

constructor⁸⁺

constructor()

Types的构造函数。

系统能力： SystemCapability.Utils.Lang

示例：

let type = new util.types();

isAnyArrayBuffer⁸⁺

isAnyArrayBuffer(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isArrayBufferView⁸⁺

isArrayBufferView(value: Object): boolean

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isArgumentsObject⁸⁺

isArgumentsObject(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isArrayBuffer⁸⁺

isArrayBuffer(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isAsyncFunction⁸⁺

isAsyncFunction(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isBooleanObject⁸⁺

isBooleanObject(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isBoxedPrimitive⁸⁺

isBoxedPrimitive(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isDataView⁸⁺

isDataView(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isDate⁸⁺

isDate(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isExternal⁸⁺

isExternal(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isFloat32Array⁸⁺

isFloat32Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isFloat64Array⁸⁺

isFloat64Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isGeneratorFunction⁸⁺

isGeneratorFunction(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isGeneratorObject⁸⁺

isGeneratorObject(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isInt8Array⁸⁺

isInt8Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isInt16Array⁸⁺

isInt16Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isInt32Array⁸⁺

isInt32Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isMap⁸⁺

isMap(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isMapIterator⁸⁺

isMapIterator(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isNativeError⁸⁺

isNativeError(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isNumberObject⁸⁺

isNumberObject(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isPromise⁸⁺

isPromise(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isProxy⁸⁺

isProxy(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isRegExp⁸⁺

isRegExp(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isSet⁸⁺

isSet(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isSetIterator⁸⁺

isSetIterator(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isStringObject⁸⁺

isStringObject(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isSymbolObjec⁸⁺

isSymbolObject(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isTypedArray⁸⁺

isTypedArray(value: Object): boolean

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

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isUint8Array⁸⁺

isUint8Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isUint8ClampedArray⁸⁺

isUint8ClampedArray(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isUint16Array⁸⁺

isUint16Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isUint32Array⁸⁺

isUint32Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isWeakMap⁸⁺

isWeakMap(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isWeakSet⁸⁺

isWeakSet(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isBigInt64Array⁸⁺

isBigInt64Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isBigUint64Array⁸⁺

isBigUint64Array(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isModuleNamespaceObject⁸⁺

isModuleNamespaceObject(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

isSharedArrayBuffer⁸⁺

isSharedArrayBuffer(value: Object): boolean

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

LruBuffer^(deprecated)

说明：

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

属性

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

示例：

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.constructor⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

示例：

let lrubuffer= new util.LruBuffer();

updateCapacity^(deprecated)

updateCapacity(newCapacity: number): void

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

说明：

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

系统能力： SystemCapability.Utils.Lang

参数：

示例：

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

toString^(deprecated)

toString(): string

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

说明：

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.getCapacity⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

clear^(deprecated)

clear(): void

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

说明：

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

系统能力： 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.getCreateCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getMissCount^(deprecated)

getMissCount(): number

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

说明：

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.getRemovalCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.getMatchCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.getPutCount⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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

isEmpty^(deprecated)

isEmpty(): boolean

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

说明：

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.get⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.put⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

values^(deprecated)

values(): V[]

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

说明：

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.keys⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.remove⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.afterRemoval⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

示例：

let arr = [];
class ChildLruBuffer<K, V> extends util.LruBuffer<K, V>
{
	constructor()
	{
		super();
	}
	afterRemoval(isEvict, key, value, newValue)
	{
		if (isEvict === false)
		{
			arr = [key, value, newValue];
		}
	}
}
let lru = new ChildLruBuffer();
lru.afterRemoval(false,10,30,null);

contains^(deprecated)

contains(key: K): boolean

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

说明：

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.createDefault⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

let pro = 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

返回值：

示例：

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

[Symbol.iterator]^(deprecated)

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

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

说明：

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

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

let pro = 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

参数：

示例：

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.toString⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.intersect⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.intersect⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.getUpper⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.getLower⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

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.expand⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.expand⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.expand⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.contains⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.contains⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.clamp⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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开始废弃，建议使用Base64Helper⁹⁺替代。

constructor^(deprecated)

constructor()

Base64的构造函数。

说明：

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

系统能力： SystemCapability.Utils.Lang

示例：

let base64 = new  util.Base64();

encodeSync^(deprecated)

encodeSync(src: Uint8Array): Uint8Array

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

说明：

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.encodeToStringSync⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.decodeSync⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.encode⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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.encodeToString⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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

decode^(deprecated)

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

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

说明：

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

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

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())
    }
})