未验证 提交 30d79c6d 编写于 作者: O openharmony_ci 提交者: Gitee

!14415 3.2Beta5:treeset和treemap优化:需同步翻译

Merge pull request !14415 from 葛亚芳/OpenHarmony-3.2-Beta5
# @ohos.util.TreeMap (非线性容器TreeMap) # @ohos.util.TreeMap (非线性容器TreeMap)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
TreeMap可用于存储具有关联关系的key-value键值对集合,存储元素中key值唯一,每个key对应一个value。 TreeMap可用于存储具有关联关系的key-value键值对集合,存储元素中key值唯一,每个key对应一个value。
TreeMap底层使用红黑树实现,可以利用二叉树特性快速查找键值对。key值有序存储,可以实现快速的插入和删除。 TreeMap底层使用红黑树实现,可以利用二叉树特性快速查找键值对。key值有序存储,可以实现快速的插入和删除。
...@@ -11,10 +8,16 @@ TreeMap和[HashMap](js-apis-treemap.md)相比,HashMap依据键的hashCode存 ...@@ -11,10 +8,16 @@ TreeMap和[HashMap](js-apis-treemap.md)相比,HashMap依据键的hashCode存
**推荐使用场景:** 一般需要存储有序键值对的场景,可以使用TreeMap。 **推荐使用场景:** 一般需要存储有序键值对的场景,可以使用TreeMap。
文档中存在泛型的使用,涉及以下泛型标记符:<br> 文档中存在泛型的使用,涉及以下泛型标记符:
- K: Key, 键<br>
- K: Key, 键
- V: Value, 值 - V: Value, 值
> **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
```ts ```ts
...@@ -563,7 +566,7 @@ while(temp != undefined) { ...@@ -563,7 +566,7 @@ while(temp != undefined) {
values(): IterableIterator&lt;V&gt; values(): IterableIterator&lt;V&gt;
返回包含此映射中包含的键值的新迭代器对象。 返回包含此映射中键值对的新迭代器对象。
**系统能力:** SystemCapability.Utils.Lang **系统能力:** SystemCapability.Utils.Lang
...@@ -609,9 +612,9 @@ forEach(callbackFn: (value?: V, key?: K, map?: TreeMap<K, V>) => void, thisArg?: ...@@ -609,9 +612,9 @@ forEach(callbackFn: (value?: V, key?: K, map?: TreeMap<K, V>) => void, thisArg?:
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callbackFn | function | 是 | 回调函数。 | | callbackFn | function | 是 | 回调函数。 |
| thisArg | Object | 否 | callbackfn被调用时用作this值。 | | thisArg | Object | 否 | callbackFn被调用时用作this值。 |
callbackfn的参数说明: callbackFn的参数说明:
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| value | V | 否 | 当前遍历到的元素键值对的值。 | | value | V | 否 | 当前遍历到的元素键值对的值。 |
...@@ -642,7 +645,7 @@ treeMap.forEach((value, key) => { ...@@ -642,7 +645,7 @@ treeMap.forEach((value, key) => {
entries(): IterableIterator<[K, V]> entries(): IterableIterator<[K, V]>
返回包含此映射中包含的键值对的新迭代器对象。 返回包含此映射中键值对的新迭代器对象。
**系统能力:** SystemCapability.Utils.Lang **系统能力:** SystemCapability.Utils.Lang
...@@ -680,7 +683,7 @@ while(temp != undefined) { ...@@ -680,7 +683,7 @@ while(temp != undefined) {
[Symbol.iterator]\(): IterableIterator&lt;[K, V]&gt; [Symbol.iterator]\(): IterableIterator&lt;[K, V]&gt;
返回一个迭代器,迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 返回一个迭代器,迭代器的每一项都是一个JavaScript对象,并返回该对象。
**系统能力:** SystemCapability.Utils.Lang **系统能力:** SystemCapability.Utils.Lang
......
# @ohos.util.TreeSet (非线性容器TreeSet) # @ohos.util.TreeSet (非线性容器TreeSet)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
TreeSet基于[TreeMap](js-apis-treemap.md)实现,在TreeSet中,只对value对象进行处理。TreeSet可用于存储一系列值的集合,元素中value唯一且有序。 TreeSet基于[TreeMap](js-apis-treemap.md)实现,在TreeSet中,只对value对象进行处理。TreeSet可用于存储一系列值的集合,元素中value唯一且有序。
TreeSet和[HashSet](js-apis-hashset.md)相比,HashSet中的数据无序存放,而TreeSet是有序存放。它们集合中的元素都不允许重复,但HashSet允许放入null值,TreeSet不允许。 TreeSet和[HashSet](js-apis-hashset.md)相比,HashSet中的数据无序存放,而TreeSet是有序存放。它们集合中的元素都不允许重复,但HashSet允许放入null值,TreeSet不允许。
**推荐使用场景:** 一般需要存储有序集合的场景,可以使用TreeSet。 **推荐使用场景:** 一般需要存储有序集合的场景,可以使用TreeSet。
文档中存在泛型的使用,涉及以下泛型标记符:<br> 文档中存在泛型的使用,涉及以下泛型标记符:
- T: Type, 类 - T: Type, 类
> **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
```ts ```ts
...@@ -436,7 +438,7 @@ treeSet.clear(); ...@@ -436,7 +438,7 @@ treeSet.clear();
values(): IterableIterator&lt;T&gt; values(): IterableIterator&lt;T&gt;
返回包含此映射中包含的键值的新迭代器对象。 返回包含此映射中键值对的新迭代器对象。
**系统能力:** SystemCapability.Utils.Lang **系统能力:** SystemCapability.Utils.Lang
...@@ -482,13 +484,13 @@ forEach(callbackFn: (value?: T, key?: T, set?: TreeSet&lt;T&gt;) => void, thisAr ...@@ -482,13 +484,13 @@ forEach(callbackFn: (value?: T, key?: T, set?: TreeSet&lt;T&gt;) => void, thisAr
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callbackFn | function | 是 | 回调函数。 | | callbackFn | function | 是 | 回调函数。 |
| thisArg | Object | 否 | callbackfn被调用时用作this值。 | | thisArg | Object | 否 | callbackFn被调用时用作this值。 |
callbackfn的参数说明: callbackFn的参数说明:
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| value | T | 否 | 当前遍历到的元素。 | | value | T | 否 | 当前遍历到的value元素。 |
| key | T | 否 | 当前遍历到的元素(和value相同)。 | | key | T | 否 | 当前遍历到的key元素。 |
| set | TreeSet&lt;T&gt; | 否 | 当前调用forEach方法的实例对象。 | | set | TreeSet&lt;T&gt; | 否 | 当前调用forEach方法的实例对象。 |
**错误码:** **错误码:**
...@@ -515,7 +517,7 @@ treeSet.forEach((value, key) => { ...@@ -515,7 +517,7 @@ treeSet.forEach((value, key) => {
entries(): IterableIterator<[T, T]> entries(): IterableIterator<[T, T]>
返回包含此映射中包含的键值对的新迭代器对象。 返回包含此映射中键值对的新迭代器对象。
**系统能力:** SystemCapability.Utils.Lang **系统能力:** SystemCapability.Utils.Lang
...@@ -553,7 +555,7 @@ while(temp != undefined) { ...@@ -553,7 +555,7 @@ while(temp != undefined) {
[Symbol.iterator]\(): IterableIterator&lt;T&gt; [Symbol.iterator]\(): IterableIterator&lt;T&gt;
返回一个迭代器,迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 返回一个迭代器,迭代器的每一项都是一个JavaScript对象,并返回该对象。
**系统能力:** SystemCapability.Utils.Lang **系统能力:** SystemCapability.Utils.Lang
...@@ -561,7 +563,7 @@ while(temp != undefined) { ...@@ -561,7 +563,7 @@ while(temp != undefined) {
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| IterableIterator&lt;T&gt; | 返回一个迭代器 | | IterableIterator&lt;T&gt; | 返回一个迭代器 |
**错误码:** **错误码:**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册