• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.ability.dataUriUtils (DataUriUtils)
2
3The **DataUriUtils** module provides APIs to process URI objects. You can use the APIs to attach an ID to the end of a given URI and obtain, delete, or update the ID attached to the end of a given URI.
4
5> **NOTE**
6>
7> The APIs of this module are supported since API version 7 and deprecated since API version 9. You are advised to use [@ohos.app.ability.dataUriUtils](js-apis-app-ability-dataUriUtils.md) instead.
8
9## Modules to Import
10
11```ts
12import dataUriUtils from '@ohos.ability.dataUriUtils';
13```
14
15## dataUriUtils.getId
16
17getId(uri: string): number
18
19Obtains the ID attached to the end of a given URI.
20
21**System capability**: SystemCapability.Ability.AbilityRuntime.Core
22
23**Parameters**
24
25| Name| Type  | Mandatory| Description                       |
26| ---- | ------ | ---- | --------------------------- |
27| uri  | string | Yes  | Target URI object.|
28
29**Return value**
30
31| Type  | Description                    |
32| ------ | ------------------------ |
33| number | ID obtained.|
34
35**Example**
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
49Attaches an ID to the end of a given URI.
50
51**System capability**: SystemCapability.Ability.AbilityRuntime.Core
52
53**Parameters**
54
55| Name| Type  | Mandatory| Description                       |
56| ---- | ------ | ---- | --------------------------- |
57| uri  | string | Yes  | Target URI object.|
58| id   | number | Yes  | ID to be attached.           |
59
60**Return value**
61
62| Type  | Description                 |
63| ------ | --------------------- |
64| string | URI object with the ID attached.|
65
66**Example**
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
84Deletes the ID from the end of a given URI.
85
86**System capability**: SystemCapability.Ability.AbilityRuntime.Core
87
88**Parameters**
89
90| Name| Type  | Mandatory| Description                       |
91| ---- | ------ | ---- | --------------------------- |
92| uri  | string | Yes  | URI object from which the ID is to be deleted.|
93
94**Return value**
95
96| Type  | Description               |
97| ------ | ------------------- |
98| string | URI object with the ID deleted.|
99
100**Example**
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
114Updates the ID in a given URI.
115
116**System capability**: SystemCapability.Ability.AbilityRuntime.Core
117
118**Parameters**
119
120| Name| Type  | Mandatory| Description               |
121| ---- | ------ | ---- | ------------------- |
122| uri  | string | Yes  | Target URI object.|
123| id   | number | Yes  | New ID.           |
124
125**Return value**
126
127| Type  | Description           |
128| ------ | --------------- |
129| string | URI object with the new ID.|
130
131**Example**
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