• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.ability.dataUriUtils (DataUriUtils模块)
2
3DataUriUtils模块提供用于处理uri对象的能力,包括获取、绑定、删除和更新指定uri对象的路径末尾的ID。本模块将被app.ability.dataUriUtils模块替代,建议优先使用[@ohos.app.ability.dataUriUtils](js-apis-app-ability-dataUriUtils.md)模块。
4
5> **说明:**
6>
7> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
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
38let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
39```
40
41
42
43## dataUriUtils.attachId
44
45attachId(uri: string, id: number): string
46
47将ID附加到uri的路径末尾。
48
49**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
50
51**参数:**
52
53| 参数名 | 类型   | 必填 | 说明                        |
54| ---- | ------ | ---- | --------------------------- |
55| uri  | string | 是   | 表示uri对象。 |
56| id   | number | 是   | 表示要附加的ID。            |
57
58**返回值:**
59
60| 类型   | 说明                  |
61| ------ | --------------------- |
62| string | 返回附加ID之后的uri对象。 |
63
64**示例:**
65
66```ts
67let id = 1122;
68let uri = dataUriUtils.attachId(
69    'com.example.dataUriUtils',
70	id,
71);
72```
73
74
75
76## dataUriUtils.deleteId
77
78deleteId(uri: string): string
79
80删除指定uri路径末尾的ID。
81
82**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
83
84**参数:**
85
86| 参数名 | 类型   | 必填 | 说明                        |
87| ---- | ------ | ---- | --------------------------- |
88| uri  | string | 是   | 表示要从中删除ID的uri对象。 |
89
90**返回值:**
91
92| 类型   | 说明                |
93| ------ | ------------------- |
94| string | 返回删除ID之后的uri对象。 |
95
96**示例:**
97
98```ts
99let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
100```
101
102
103
104## dataUriUtils.updateId
105
106updateId(uri: string, id: number): string
107
108更新指定uri中的ID。
109
110**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
111
112**参数:**
113
114| 参数名 | 类型   | 必填 | 说明                |
115| ---- | ------ | ---- | ------------------- |
116| uri  | string | 是   | 表示uri对象 |
117| id   | number | 是   | 表示要更新的ID            |
118
119**返回值:**
120
121| 类型   | 说明            |
122| ------ | --------------- |
123| string | 返回更新ID之后的uri对象。 |
124
125**示例:**
126
127```ts
128let id = 1122;
129let uri = dataUriUtils.updateId(
130    'com.example.dataUriUtils/1221',
131	id
132);
133```
134
135