1# @ohos.ability.dataUriUtils (DataUriUtils模块)
2
3DataUriUtils模块提供用于处理uri对象的能力,包括获取、绑定、删除和更新指定uri对象的路径末尾的ID。
4
5> **说明:**
6>
7> 本模块首批接口从API version 7开始支持,从API version 9废弃,替换模块为[@ohos.app.ability.dataUriUtils](js-apis-app-ability-dataUriUtils.md)。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import dataUriUtils from '@ohos.ability.dataUriUtils';
13```
14
15## dataUriUtils.getId
16
17getId(uri: string): number
18
19获取指定uri路径末尾的ID。
20
21**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
22
23**参数:**
24
25| 参数名 | 类型   | 必填 | 说明                        |
26| ---- | ------ | ---- | --------------------------- |
27| uri  | string | 是   | 表示uri对象。 |
28
29**返回值:**
30
31| 类型   | 说明                     |
32| ------ | ------------------------ |
33| number | 返回uri路径末尾的ID。 |
34
35**示例:**
36
37```ts
38import dataUriUtils from '@ohos.ability.dataUriUtils';
39
40let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
41```
42
43
44
45## dataUriUtils.attachId
46
47attachId(uri: string, id: number): string
48
49将ID附加到uri的路径末尾。
50
51**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
52
53**参数:**
54
55| 参数名 | 类型   | 必填 | 说明                        |
56| ---- | ------ | ---- | --------------------------- |
57| uri  | string | 是   | 表示uri对象。 |
58| id   | number | 是   | 表示要附加的ID。            |
59
60**返回值:**
61
62| 类型   | 说明                  |
63| ------ | --------------------- |
64| string | 返回附加ID之后的uri对象。 |
65
66**示例:**
67
68```ts
69import dataUriUtils from '@ohos.ability.dataUriUtils';
70
71let id = 1122;
72let uri = dataUriUtils.attachId(
73    'com.example.dataUriUtils',
74	id,
75);
76```
77
78
79
80## dataUriUtils.deleteId
81
82deleteId(uri: string): string
83
84删除指定uri路径末尾的ID。
85
86**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
87
88**参数:**
89
90| 参数名 | 类型   | 必填 | 说明                        |
91| ---- | ------ | ---- | --------------------------- |
92| uri  | string | 是   | 表示要从中删除ID的uri对象。 |
93
94**返回值:**
95
96| 类型   | 说明                |
97| ------ | ------------------- |
98| string | 返回删除ID之后的uri对象。 |
99
100**示例:**
101
102```ts
103import dataUriUtils from '@ohos.ability.dataUriUtils';
104
105let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
106```
107
108
109
110## dataUriUtils.updateId
111
112updateId(uri: string, id: number): string
113
114更新指定uri中的ID。
115
116**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
117
118**参数:**
119
120| 参数名 | 类型   | 必填 | 说明                |
121| ---- | ------ | ---- | ------------------- |
122| uri  | string | 是   | 表示uri对象 |
123| id   | number | 是   | 表示要更新的ID            |
124
125**返回值:**
126
127| 类型   | 说明            |
128| ------ | --------------- |
129| string | 返回更新ID之后的uri对象。 |
130
131**示例:**
132
133```ts
134import dataUriUtils from '@ohos.ability.dataUriUtils';
135
136let id = 1122;
137let uri = dataUriUtils.updateId(
138    'com.example.dataUriUtils/1221',
139	id
140);
141```
142
143