From feb588f75833fddd9dfecd08cb65d8af9fab2b0b Mon Sep 17 00:00:00 2001 From: bi-hu Date: Fri, 17 Feb 2023 17:52:44 +0800 Subject: [PATCH] Modify the docs error description in the containers module to monthly_20221018 Signed-off-by: bi-hu --- .../reference/apis/js-apis-deque.md | 12 ++++++----- .../reference/apis/js-apis-hashmap.md | 16 ++++++++------- .../reference/apis/js-apis-linkedlist.md | 14 ++++++++----- .../reference/apis/js-apis-list.md | 12 ++++++----- .../reference/apis/js-apis-treemap.md | 2 +- .../reference/apis/js-apis-treeset.md | 2 +- .../reference/errorcodes/errorcode-utils.md | 20 ++++++++++++++++++- 7 files changed, 53 insertions(+), 25 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-deque.md b/zh-cn/application-dev/reference/apis/js-apis-deque.md index b79633c519..142602771d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-deque.md +++ b/zh-cn/application-dev/reference/apis/js-apis-deque.md @@ -1,8 +1,5 @@ # @ohos.util.Deque (线性容器Deque) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - Deque（double ended queue）根据循环队列的数据结构实现，符合先进先出以及先进后出的特点，支持两端的元素插入和移除。Deque会根据实际需要动态调整容量，每次进行两倍扩容。 Deque和[Queue](js-apis-queue.md)相比，Queue的特点是先进先出，只能在头部删除元素，尾部增加元素。 @@ -11,8 +8,13 @@ Deque和[Queue](js-apis-queue.md)相比，Queue的特点是先进先出，只能 **推荐使用场景：** 需要频繁在集合两端进行增删元素的操作时，推荐使用Deque。 -文档中存在泛型的使用,涉及以下泛型标记符:
-- T: Type, 类 +文档中存在泛型的使用，涉及以下泛型标记符：
+- T：Type，类 + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> +> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hashmap.md b/zh-cn/application-dev/reference/apis/js-apis-hashmap.md index 7f0a90a4aa..06e5c93631 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hashmap.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hashmap.md @@ -1,8 +1,5 @@ # @ohos.util.HashMap (非线性容器HashMap) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - HashMap底层使用数组+链表+红黑树的方式实现，查询、插入和删除的效率都很高。HashMap存储内容基于key-value的键值对映射，不能有重复的key，且一个key只能对应一个value。 HashMap和[TreeMap](js-apis-treemap.md)相比，HashMap依据键的hashCode存取数据，访问速度较快。而TreeMap是有序存取，效率较低。 @@ -11,9 +8,14 @@ HashMap和[TreeMap](js-apis-treemap.md)相比，HashMap依据键的hashCode存 **推荐使用场景：** 需要快速存取、删除以及插入键值对数据时，推荐使用HashMap。 -文档中存在泛型的使用,涉及以下泛型标记符:
-- K: Key, 键
-- V: Value, 值 +文档中存在泛型的使用，涉及以下泛型标记符：
+- K：Key，键
+- V：Value，值 + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> +> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + ## 导入模块 @@ -337,7 +339,7 @@ hashMap.clear(); keys(): IterableIterator<K> -返回包含此映射中包含的键名的新迭代器对象。 +返回包含此映射中包含的键的新迭代器对象。 **系统能力：** SystemCapability.Utils.Lang diff --git a/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md b/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md index f520831d60..cc1564f43a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md +++ b/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md @@ -1,8 +1,5 @@ # @ohos.util.LinkedList (线性容器LinkedList) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - LinkedList底层通过双向链表实现，双向链表的每个节点都包含对前一个元素和后一个元素的引用。当需要查询元素时，可以从头遍历，也可以从尾部遍历，插入、删除效率高，查询效率低。LinkedList允许元素为null。 LinkedList和[List](js-apis-list.md)相比，LinkedList是双向链表，可以快速地在头尾进行增删，而List是单向链表，无法双向操作。 @@ -11,8 +8,13 @@ LinkedList和[ArrayList](js-apis-arraylist.md)相比，插入数据效率LinkedL **推荐使用场景：** 当需要频繁的插入删除时，推荐使用LinkedList高效操作。 -文档中存在泛型的使用,涉及以下泛型标记符:
-- T: Type, 类 +文档中存在泛型的使用，涉及以下泛型标记符：
+- T：Type，类 + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> +> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + ## 导入模块 @@ -505,6 +507,7 @@ removeFirstFound(element: T): boolean | -------- | -------- | | 10200011 | The removeFirstFound method cannot be bound. | | 10200010 | Container is empty. | +| 10200017 | The element does not exist in this container. | **示例：** @@ -545,6 +548,7 @@ removeLastFound(element: T): boolean | -------- | -------- | | 10200011 | The removeLastFound method cannot be bound. | | 10200010 | Container is empty. | +| 10200017 | The element does not exist in this container. | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-list.md b/zh-cn/application-dev/reference/apis/js-apis-list.md index a4f380e16e..e399c28c79 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-list.md +++ b/zh-cn/application-dev/reference/apis/js-apis-list.md @@ -1,16 +1,18 @@ # @ohos.util.List (线性容器List) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - List底层通过单向链表实现，每个节点有一个指向后一个元素的引用。当需要查询元素时，必须从头遍历，插入、删除效率高，查询效率低。List允许元素为null。 List和[LinkedList](js-apis-linkedlist.md)相比，LinkedList是双向链表，可以快速地在头尾进行增删，而List是单向链表，无法双向操作。 **推荐使用场景：** 当需要频繁的插入删除时，推荐使用List高效操作。 -文档中存在泛型的使用,涉及以下泛型标记符:
-- T: Type, 类 +文档中存在泛型的使用，涉及以下泛型标记符：
+- T：Type，类 + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> +> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-treemap.md b/zh-cn/application-dev/reference/apis/js-apis-treemap.md index eb8d83f1e0..99fabdacb0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-treemap.md +++ b/zh-cn/application-dev/reference/apis/js-apis-treemap.md @@ -566,7 +566,7 @@ while(temp != undefined) { values(): IterableIterator<V> -返回包含此映射中键值对的新迭代器对象。 +返回包含此映射中键值的新迭代器对象。 **系统能力：** SystemCapability.Utils.Lang diff --git a/zh-cn/application-dev/reference/apis/js-apis-treeset.md b/zh-cn/application-dev/reference/apis/js-apis-treeset.md index fb3fb67678..9c035500ea 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-treeset.md +++ b/zh-cn/application-dev/reference/apis/js-apis-treeset.md @@ -438,7 +438,7 @@ treeSet.clear(); values(): IterableIterator<T> -返回包含此映射中键值对的新迭代器对象。 +返回包含此映射中键值的新迭代器对象。 **系统能力：** SystemCapability.Utils.Lang diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-utils.md b/zh-cn/application-dev/reference/errorcodes/errorcode-utils.md index 9dd0d2ccf0..eab38038d2 100644 --- a/zh-cn/application-dev/reference/errorcodes/errorcode-utils.md +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-utils.md @@ -272,4 +272,22 @@ The task is running when cancel it. **处理步骤** -取消任务前，确保任务已被执行完毕。 \ No newline at end of file +取消任务前，确保任务已被执行完毕。 + +## 10200017 删除不存在的元素错误 + +**错误信息** + +The element does not exist in this container. + +**错误描述** + +删除的元素不存在此容器中。 + +**可能原因** + +删除元素时，此容器中不存在此元素。 + +**处理步骤** + +删除元素前，确保元素存在于此容器中。 \ No newline at end of file -- GitLab