Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 8bb856a6 编写于 作者: A Annie_wang
浏览文件
操作

update docs 

Signed-off-by: NAnnie_wang <annie.wangli@huawei.com>
上级 94009e19
隐藏空白更改
内联 并排
Showing with 99 addition and 171 deletion
en/application-dev/reference/apis/js-apis-document.md
浏览文件 @ 8bb856a6
...@@ -14,21 +14,21 @@ import document from '@ohos.document'; ...@@ -14,21 +14,21 @@ import document from '@ohos.document';
choose(types? : string[]): Promise&lt;string&gt; choose(types? : string[]): Promise&lt;string&gt;
Chooses a file of the specified type using the file manager. This API uses a promise to return the result. Chooses files of the specified types using the file manager. This API uses a promise to return the result.
**System capability**: SystemCapability.FileManagement.UserFileService **System capability**: SystemCapability.FileManagement.UserFileService
**Parameters** **Parameters**
| Name| Type | Mandatory| Description | | Name| Type | Mandatory| Description |
| ------ | ------ | ---- | ---------------------------- | | ------ | ------ | ---- | ---------------------------- |
| types | string[] | No | Type of the file to choose.| | types | string[] | No | Types of the files to choose. |
**Return value** **Return value**
| Type | Description | | Type | Description |
| --------------------- | -------------- | | --------------------- | -------------- |
| Promise&lt;string&gt; | Promise used to return the result. An error code is returned.| | Promise&lt;string&gt; | Promise used to return the result. An error code is returned.|
**Example** **Example**
...@@ -46,9 +46,9 @@ Chooses a file using the file manager. This API uses an asynchronous callback to ...@@ -46,9 +46,9 @@ Chooses a file using the file manager. This API uses an asynchronous callback to
**Parameters** **Parameters**
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | --------------------------- | ---- | ---------------------------- | | -------- | --------------------------- | ---- | ---------------------------- |
| callback | AsyncCallback&lt;string&gt; | Yes | Callback used to return the result. An error code is returned.| | callback | AsyncCallback&lt;string&gt; | Yes | Callback used to return the result. An error code is returned.|
**Example** **Example**
...@@ -62,16 +62,16 @@ Chooses a file using the file manager. This API uses an asynchronous callback to ...@@ -62,16 +62,16 @@ Chooses a file using the file manager. This API uses an asynchronous callback to
choose(types:string[], callback:AsyncCallback&lt;string&gt;): void choose(types:string[], callback:AsyncCallback&lt;string&gt;): void
Chooses a file using the file manager. This API uses an asynchronous callback to return the result. Chooses files using the file manager. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.FileManagement.UserFileService **System capability**: SystemCapability.FileManagement.UserFileService
**Parameters** **Parameters**
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | --------------------------- | ---- | ---------------------------- | | -------- | --------------------------- | ---- | ---------------------------- |
| types | string[] | No | Type of the file to choose.| | types | string[] | No | Types of the files to choose.|
| callback | AsyncCallback&lt;string&gt; | Yes | Callback used to return the result. An error code is returned.| | callback | AsyncCallback&lt;string&gt; | Yes | Callback used to return the result. An error code is returned.|
**Example** **Example**
...@@ -93,16 +93,16 @@ Opens a file. This API uses a promise to return the result. ...@@ -93,16 +93,16 @@ Opens a file. This API uses a promise to return the result.
**Parameters** **Parameters**
| Name| Type | Mandatory| Description | | Name| Type | Mandatory| Description |
| ---- | ------ | ---- | ---------------------------- | | ---- | ------ | ---- | ---------------------------- |
| uri | string | Yes | URI of the file to open.| | uri | string | Yes | URI of the file to open.|
| type | string | Yes | Type of the file to open.| | type | string | Yes | Type of the file to open.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| --------------------- | ------------ | | --------------------- | ------------ |
| Promise&lt;void&gt; | Promise used to return the result. An error code is returned.| | Promise&lt;void&gt; | Promise used to return the result. An error code is returned.|
**Example** **Example**
...@@ -122,11 +122,11 @@ Opens a file. This API uses an asynchronous callback to return the result. ...@@ -122,11 +122,11 @@ Opens a file. This API uses an asynchronous callback to return the result.
**Parameters** **Parameters**
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | --------------------------- | ---- | ---------------------------- | | -------- | --------------------------- | ---- | ---------------------------- |
| uri | string | Yes | URI of the file to open.| | uri | string | Yes | URI of the file to open.|
| type | string | Yes | Type of the file to open.| | type | string | Yes | Type of the file to open.|
| callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. An error code is returned. | | callback | AsyncCallback&lt;void&gt; | Yes | Callback used to return the result. An error code is returned. |
**Example** **Example**
......
en/application-dev/reference/apis/js-apis-fileio.md
浏览文件 @ 8bb856a6
...@@ -16,6 +16,7 @@ import fileio from '@ohos.fileio'; ...@@ -16,6 +16,7 @@ import fileio from '@ohos.fileio';
## Guidelines ## Guidelines
Before using the APIs provided by this module to perform operations on files or directories, obtain the path of the application sandbox as follows: Before using the APIs provided by this module to perform operations on files or directories, obtain the path of the application sandbox as follows:
```js ```js
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let context = featureAbility.getContext(); let context = featureAbility.getContext();
...@@ -353,58 +354,11 @@ Synchronously closes a file. ...@@ -353,58 +354,11 @@ Synchronously closes a file.
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
fileio.closeSync(fd); fileio.closeSync(fd);
``` ```
## fileio.close<sup>7+</sup>
close(): Promise&lt;void&gt;
Closes the stream. This API uses a promise to return the result.
**System capability**: SystemCapability.FileManagement.File.FileIO
**Return value**
| Type | Description |
| ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise that returns no value.|
**Example**
```js
fileio.close().then(function(){
console.info("File stream closed");
}).catch(function(err){
console.info("Failed to close the file stream. Error:"+ err);
});
```
## fileio.close<sup>7+</sup>
close(callback: AsyncCallback&lt;void&gt;): void
Closes the stream. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.FileManagement.File.FileIO
**Parameters**
| Name | Type | Mandatory | Description |
| -------- | ------------------------- | ---- | ------------- |
| callback | AsyncCallback&lt;void&gt; | Yes | Callback invoked when the stream is closed asynchronously.|
**Example**
```js
fileio.close(function(err){
// Do something.
});
```
## fileio.copyFile ## fileio.copyFile
copyFile(src:string | number, dest:string | number, mode?:number):Promise&lt;void&gt; copyFile(src:string | number, dest:string | number, mode?:number):Promise&lt;void&gt;
...@@ -430,6 +384,8 @@ Copies a file. This API uses a promise to return the result. ...@@ -430,6 +384,8 @@ Copies a file. This API uses a promise to return the result.
**Example** **Example**
```js ```js
let src = path;
let dest = src + 'tgt';
fileio.copyFile(src, dest).then(function(){ fileio.copyFile(src, dest).then(function(){
console.info("File copied"); console.info("File copied");
}).catch(function(err){ }).catch(function(err){
...@@ -458,6 +414,8 @@ Copies a file. This API uses an asynchronous callback to return the result. ...@@ -458,6 +414,8 @@ Copies a file. This API uses an asynchronous callback to return the result.
**Example** **Example**
```js ```js
let src = path;
let dest = src + 'tgt';
fileio.copyFile(src, dest, function (err) { fileio.copyFile(src, dest, function (err) {
// Do something. // Do something.
}); });
...@@ -483,6 +441,8 @@ Synchronously copies a file. ...@@ -483,6 +441,8 @@ Synchronously copies a file.
**Example** **Example**
```js ```js
let src = path;
let dest = src + 'tgt';
fileio.copyFileSync(src, dest); fileio.copyFileSync(src, dest);
``` ```
...@@ -957,7 +917,7 @@ Writes data into a file. This API uses a promise to return the result. ...@@ -957,7 +917,7 @@ Writes data into a file. This API uses a promise to return the result.
```js ```js
let fd = fileio.openSync(path, 0o100 | 0o2, 0o666); let fd = fileio.openSync(path, 0o100 | 0o2, 0o666);
fileio.write(fd, "hello, world").then(function(number){ fileio.write(fd, "hello, world").then(function(number){
console.info("Data written to file and size is:"+ number); console.info("Data written to the file. Size is:"+ number);
}).catch(function(err){ }).catch(function(err){
console.info("Failed to write data to the file. Error:"+ err); console.info("Failed to write data to the file. Error:"+ err);
}); });
...@@ -992,7 +952,7 @@ Writes data into a file. This API uses an asynchronous callback to return the re ...@@ -992,7 +952,7 @@ Writes data into a file. This API uses an asynchronous callback to return the re
let fd = fileio.openSync(path, 0o100 | 0o2, 0o666); let fd = fileio.openSync(path, 0o100 | 0o2, 0o666);
fileio.write(fd, "hello, world", function (err, bytesWritten) { fileio.write(fd, "hello, world", function (err, bytesWritten) {
if (bytesWritten) { if (bytesWritten) {
console.info("Data written to file and size is:"+ bytesWritten); console.info("Data written to the file. Size is:"+ bytesWritten);
} }
}); });
``` ```
...@@ -1059,7 +1019,7 @@ Calculates the hash value of a file. This API uses a promise to return the resul ...@@ -1059,7 +1019,7 @@ Calculates the hash value of a file. This API uses a promise to return the resul
```js ```js
fileio.hash(path, "sha256").then(function(str){ fileio.hash(path, "sha256").then(function(str){
console.info("Calculated file hash:"+ str); console.info("Calculated file hash:"+ str);
}).catch(function(error){ }).catch(function(err){
console.info("Failed to calculate the file hash. Error:"+ err); console.info("Failed to calculate the file hash. Error:"+ err);
}); });
``` ```
...@@ -1116,7 +1076,7 @@ Changes file permissions. This API uses a promise to return the result. ...@@ -1116,7 +1076,7 @@ Changes file permissions. This API uses a promise to return the result.
**Example** **Example**
```js ```js
fileio.chmod(path, mode).then(function() { fileio.chmod(path, 0o700).then(function() {
console.info("File permissions changed"); console.info("File permissions changed");
}).catch(function(err){ }).catch(function(err){
console.info("Failed to change file permissions. Error:"+ err); console.info("Failed to change file permissions. Error:"+ err);
...@@ -1143,7 +1103,7 @@ Changes file permissions. This API uses an asynchronous callback to return the r ...@@ -1143,7 +1103,7 @@ Changes file permissions. This API uses an asynchronous callback to return the r
**Example** **Example**
```js ```js
fileio.chmod(path, mode, function (err) { fileio.chmod(path, 0o700, function (err) {
// Do something. // Do something.
}); });
``` ```
...@@ -1167,7 +1127,7 @@ Synchronously changes file permissions. ...@@ -1167,7 +1127,7 @@ Synchronously changes file permissions.
**Example** **Example**
```js ```js
fileio.chmodSync(path, mode); fileio.chmodSync(path, 0o700);
``` ```
...@@ -1194,10 +1154,11 @@ Obtains file information based on the file descriptor. This API uses a promise t ...@@ -1194,10 +1154,11 @@ Obtains file information based on the file descriptor. This API uses a promise t
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
fileio.fstat(fd).then(function(stat){ fileio.fstat(fd).then(function(stat){
console.info("File information obtained:"+ JSON.stringify(stat)); console.info("Obtained file info:"+ JSON.stringify(stat));
}).catch(function(err){ }).catch(function(err){
console.info("Failed to obtain file information. Error:"+ err); console.info("Failed to obtain file info. Error:"+ err);
}); });
``` ```
...@@ -1307,7 +1268,9 @@ Truncates a file based on the file descriptor. This API uses an asynchronous cal ...@@ -1307,7 +1268,9 @@ Truncates a file based on the file descriptor. This API uses an asynchronous cal
**Example** **Example**
```js ```js
fileio.ftruncate(fd, len, function(err){ let fd = fileio.openSync(path);
let len = 5;
fileio.ftruncate(fd, 5, function(err){
// Do something. // Do something.
}); });
``` ```
...@@ -1331,6 +1294,8 @@ Synchronously truncates a file based on the file descriptor. ...@@ -1331,6 +1294,8 @@ Synchronously truncates a file based on the file descriptor.
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
let len = 5;
fileio.ftruncateSync(fd, len); fileio.ftruncateSync(fd, len);
``` ```
...@@ -1347,7 +1312,7 @@ Truncates a file based on the file path. This API uses a promise to return the r ...@@ -1347,7 +1312,7 @@ Truncates a file based on the file path. This API uses a promise to return the r
| Name| Type | Mandatory| Description | | Name| Type | Mandatory| Description |
| ------ | ------ | ---- | -------------------------------- | | ------ | ------ | ---- | -------------------------------- |
| path | string | Yes | Application sandbox path of the file to truncate. | | path | string | Yes | Application sandbox path of the file to truncate.|
| len | number | No | File length, in bytes, after truncation.| | len | number | No | File length, in bytes, after truncation.|
**Return value** **Return value**
...@@ -1359,6 +1324,7 @@ Truncates a file based on the file path. This API uses a promise to return the r ...@@ -1359,6 +1324,7 @@ Truncates a file based on the file path. This API uses a promise to return the r
**Example** **Example**
```js ```js
let len = 5;
fileio.truncate(path, len).then(function(){ fileio.truncate(path, len).then(function(){
console.info("File truncated"); console.info("File truncated");
}).catch(function(err){ }).catch(function(err){
...@@ -1386,6 +1352,7 @@ Truncates a file based on the file path. This API uses an asynchronous callback ...@@ -1386,6 +1352,7 @@ Truncates a file based on the file path. This API uses an asynchronous callback
**Example** **Example**
```js ```js
let len = 5;
fileio.truncate(path, len, function(err){ fileio.truncate(path, len, function(err){
// Do something. // Do something.
}); });
...@@ -1410,6 +1377,7 @@ Synchronously truncates a file based on the file path. ...@@ -1410,6 +1377,7 @@ Synchronously truncates a file based on the file path.
**Example** **Example**
```js ```js
let len = 5;
fileio.truncateSync(path, len); fileio.truncateSync(path, len);
``` ```
...@@ -1443,9 +1411,9 @@ Reads the text content of a file. This API uses a promise to return the result. ...@@ -1443,9 +1411,9 @@ Reads the text content of a file. This API uses a promise to return the result.
```js ```js
fileio.readText(path).then(function(str) { fileio.readText(path).then(function(str) {
console.info("Read file text:"+ str); console.info("Read text:"+ str);
}).catch(function(err){ }).catch(function(err){
console.info("Failed to read text. Error:"+ err); console.info("Failed to read the text. Error:"+ err);
}); });
``` ```
...@@ -1467,13 +1435,13 @@ Reads the text content of a file. This API uses an asynchronous callback to retu ...@@ -1467,13 +1435,13 @@ Reads the text content of a file. This API uses an asynchronous callback to retu
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | --------------------------- | ---- | ------------------------------------------------------------ | | -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| filePath | string | Yes | Application sandbox path of the file to read. | | filePath | string | Yes | Application sandbox path of the file to read. |
| options | Object | No | The options are as follows:<br>-&nbsp;**position** (number): position of the data to read in the file. By default, data is read from the current position.<br>-&nbsp;**length** (number): length of the data to read. The default value is the buffer length minus the offset.<br>- &nbsp;**encoding**: format of the string to be encoded. The default value is &nbsp;**utf-8**, which is the only value supported.| | options | Object | Yes | The options are as follows:<br>-&nbsp;**position** (number): position of the data to read in the file. By default, data is read from the current position.<br>-&nbsp;**length** (number): length of the data to read. The default value is the buffer length minus the offset.<br>- &nbsp;**encoding**: format of the string to be encoded. The default value is &nbsp;**utf-8**, which is the only value supported.|
| callback | AsyncCallback&lt;string&gt; | Yes | Callback used to return the content read. | | callback | AsyncCallback&lt;string&gt; | Yes | Callback used to return the content read. |
**Example** **Example**
```js ```js
fileio.readText(path, function(err, str){ fileio.readText(path, { position: 1, encoding: 'UTF-8' }, function(err, str){
// Do something. // Do something.
}); });
``` ```
...@@ -1537,7 +1505,7 @@ Obtains link information. This API uses a promise to return the result. ...@@ -1537,7 +1505,7 @@ Obtains link information. This API uses a promise to return the result.
fileio.lstat(path).then(function(stat){ fileio.lstat(path).then(function(stat){
console.info("Got link info:"+ JSON.stringify(stat)); console.info("Got link info:"+ JSON.stringify(stat));
}).catch(function(err){ }).catch(function(err){
console.info("Failed to obtain the link status. Error:"+ err); console.info("Failed to obtain link info. Error:"+ err);
}); });
``` ```
...@@ -1593,76 +1561,6 @@ Synchronously obtains the link information. ...@@ -1593,76 +1561,6 @@ Synchronously obtains the link information.
``` ```
## fileio.read<sup>7+</sup>
read(buffer: ArrayBuffer, options?: {
position?: number;
offset?: number;
length?: number;
}): Promise&lt;ReadOut&gt;
Reads data from a file. This API uses a promise to return the result.
**System capability**: SystemCapability.FileManagement.File.FileIO
**Parameters**
| Name | Type | Mandatory| Description |
| ------- | ----------- | ---- | ------------------------------------------------------------ |
| buffer | ArrayBuffer | Yes | Buffer used to store the file data read. |
| options | Object | No | The options are as follows:<br>-&nbsp;**offset** (number): position to store the data read in the buffer in reference to the start address of the buffer. The default value is **0**.<br>-&nbsp;**length** (number): length of the data to read. The default value is the buffer length minus the offset.<br>Constraints: offset + length <= Buffer size|
**Return value**
| Type | Description |
| ---------------------------------- | ------ |
| Promise&lt;[ReadOut](#readout)&gt; | Promise used to return the data read.|
**Example**
```js
fileio.read(new ArrayBuffer(4096)).then(function(readout){
console.info("Read file data");
console.log(String.fromCharCode.apply(null, new Uint8Array(readOut.buffer)));
}).catch(function(err){
console.info("Failed to read file data. Error:"+ err);
});
```
## fileio.read<sup>7+</sup>
read(buffer: ArrayBuffer, options: {
position?: number;
offset?: number;
length?: number;
}, callback: AsyncCallback&lt;ReadOut&gt;): void
Reads data from a file. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.FileManagement.File.FileIO
**Parameters**
| Name | Type | Mandatory | Description |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| buffer | ArrayBuffer | Yes | Buffer used to store the file data read. |
| options | Object | No | The options are as follows:<br>-&nbsp;**offset** (number): position to store the data read in the buffer in reference to the start address of the buffer. The default value is **0**.<br>-&nbsp;**length** (number): length of the data to read. The default value is the buffer length minus the offset.<br>Constraints: offset + length <= Buffer size|
| callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | Yes | Callback invoked when the data is read asynchronously from the file. |
**Example**
```js
let buf = new ArrayBuffer(4096);
fileio.read(buf, function (err, readOut) {
if (readOut) {
console.info("Read file data");
console.log(String.fromCharCode.apply(null, new Uint8Array(readOut.buffer)));
}
});
```
## fileio.rename<sup>7+</sup> ## fileio.rename<sup>7+</sup>
rename(oldPath: string, newPath: string): Promise&lt;void&gt; rename(oldPath: string, newPath: string): Promise&lt;void&gt;
...@@ -1687,6 +1585,8 @@ Renames a file. This API uses a promise to return the result. ...@@ -1687,6 +1585,8 @@ Renames a file. This API uses a promise to return the result.
**Example** **Example**
```js ```js
let oldPath = path;
let newPath = oldPath + '123';
fileio.rename(oldPath, newPath).then(function() { fileio.rename(oldPath, newPath).then(function() {
console.info("File renamed"); console.info("File renamed");
}).catch(function(err){ }).catch(function(err){
...@@ -1714,6 +1614,8 @@ Renames a file. This API uses an asynchronous callback to return the result. ...@@ -1714,6 +1614,8 @@ Renames a file. This API uses an asynchronous callback to return the result.
**Example** **Example**
```js ```js
let oldPath = path;
let newPath = oldPath + '123';
fileio.rename(oldPath, newPath, function(err){ fileio.rename(oldPath, newPath, function(err){
}); });
``` ```
...@@ -1737,6 +1639,8 @@ Synchronously renames a file. ...@@ -1737,6 +1639,8 @@ Synchronously renames a file.
**Example** **Example**
```js ```js
let oldPath = path;
let newPath = oldPath + '123';
fileio.renameSync(oldPath, newPath); fileio.renameSync(oldPath, newPath);
``` ```
...@@ -1764,6 +1668,7 @@ Flushes data of a file to disk. This API uses a promise to return the result. ...@@ -1764,6 +1668,7 @@ Flushes data of a file to disk. This API uses a promise to return the result.
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
fileio.fsync(fd).then(function(){ fileio.fsync(fd).then(function(){
console.info("Data flushed"); console.info("Data flushed");
}).catch(function(err){ }).catch(function(err){
...@@ -1790,6 +1695,7 @@ Flushes data of a file to disk. This API uses an asynchronous callback to return ...@@ -1790,6 +1695,7 @@ Flushes data of a file to disk. This API uses an asynchronous callback to return
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
fileio.fsync(fd, function(err){ fileio.fsync(fd, function(err){
// Do something. // Do something.
}); });
...@@ -1813,6 +1719,7 @@ Flushes data of a file to disk in synchronous mode. ...@@ -1813,6 +1719,7 @@ Flushes data of a file to disk in synchronous mode.
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
fileio.fsyncSync(fd); fileio.fsyncSync(fd);
``` ```
...@@ -1840,6 +1747,7 @@ Flushes data of a file to disk. This API uses a promise to return the result. ** ...@@ -1840,6 +1747,7 @@ Flushes data of a file to disk. This API uses a promise to return the result. **
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
fileio.fdatasync(fd).then(function(err) { fileio.fdatasync(fd).then(function(err) {
console.info("Data flushed"); console.info("Data flushed");
}).catch(function(err){ }).catch(function(err){
...@@ -1866,6 +1774,7 @@ Flushes data of a file to disk. This API uses an asynchronous callback to return ...@@ -1866,6 +1774,7 @@ Flushes data of a file to disk. This API uses an asynchronous callback to return
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
fileio.fdatasync (fd, function (err) { fileio.fdatasync (fd, function (err) {
// Do something. // Do something.
}); });
...@@ -1889,6 +1798,7 @@ Synchronizes data in a file in synchronous mode. ...@@ -1889,6 +1798,7 @@ Synchronizes data in a file in synchronous mode.
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
let stat = fileio.fdatasyncSync(fd); let stat = fileio.fdatasyncSync(fd);
``` ```
...@@ -1917,6 +1827,8 @@ Creates a symbolic link based on the file path. This API uses a promise to retur ...@@ -1917,6 +1827,8 @@ Creates a symbolic link based on the file path. This API uses a promise to retur
**Example** **Example**
```js ```js
let target = path;
let srcPath = target + 'aaa';
fileio.symlink(target, srcPath).then(function() { fileio.symlink(target, srcPath).then(function() {
console.info("Symbolic link created"); console.info("Symbolic link created");
}).catch(function(err){ }).catch(function(err){
...@@ -1944,6 +1856,8 @@ Creates a symbolic link based on the file path. This API uses an asynchronous ca ...@@ -1944,6 +1856,8 @@ Creates a symbolic link based on the file path. This API uses an asynchronous ca
**Example** **Example**
```js ```js
let target = path;
let srcPath = target + 'aaa';
fileio.symlink(target, srcPath, function (err) { fileio.symlink(target, srcPath, function (err) {
// Do something. // Do something.
}); });
...@@ -1968,6 +1882,8 @@ Synchronously creates a symbolic link based on a specified path. ...@@ -1968,6 +1882,8 @@ Synchronously creates a symbolic link based on a specified path.
**Example** **Example**
```js ```js
let target = path;
let srcPath = target + 'aaa';
fileio.symlinkSync(target, srcPath); fileio.symlinkSync(target, srcPath);
``` ```
...@@ -2083,7 +1999,7 @@ Creates a temporary directory. This API uses a promise to return the result. ...@@ -2083,7 +1999,7 @@ Creates a temporary directory. This API uses a promise to return the result.
fileio.mkdtemp(path + "XXXX").then(function(path){ fileio.mkdtemp(path + "XXXX").then(function(path){
console.info("Temporary directory created:"+ path); console.info("Temporary directory created:"+ path);
}).catch(function(err){ }).catch(function(err){
console.info("Failed to create a temporary directory. Error:"+ err); console.info("Failed to create the temporary directory. Error:"+ err);
}); });
``` ```
...@@ -2163,6 +2079,8 @@ Changes file permissions based on the file descriptor. This API uses a promise t ...@@ -2163,6 +2079,8 @@ Changes file permissions based on the file descriptor. This API uses a promise t
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
let mode = 0o700;
fileio.fchmod(fd, mode).then(function() { fileio.fchmod(fd, mode).then(function() {
console.info("File permissions changed"); console.info("File permissions changed");
}).catch(function(err){ }).catch(function(err){
...@@ -2190,6 +2108,8 @@ Changes file permissions based on the file descriptor. This API uses an asynchro ...@@ -2190,6 +2108,8 @@ Changes file permissions based on the file descriptor. This API uses an asynchro
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
let mode = 0o700;
fileio.fchmod(fd, mode, function (err) { fileio.fchmod(fd, mode, function (err) {
// Do something. // Do something.
}); });
...@@ -2214,6 +2134,8 @@ Synchronously changes the file permissions based on the file descriptor. ...@@ -2214,6 +2134,8 @@ Synchronously changes the file permissions based on the file descriptor.
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
let mode = 0o700;
fileio.fchmodSync(fd, mode); fileio.fchmodSync(fd, mode);
``` ```
...@@ -2416,6 +2338,7 @@ Changes the file owner based on the file descriptor. This API uses a promise to ...@@ -2416,6 +2338,7 @@ Changes the file owner based on the file descriptor. This API uses a promise to
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
let stat = fileio.statSync(path); let stat = fileio.statSync(path);
fileio.fchown(fd, stat.uid, stat.gid).then(function() { fileio.fchown(fd, stat.uid, stat.gid).then(function() {
console.info("File owner changed"); console.info("File owner changed");
...@@ -2445,6 +2368,7 @@ Changes the file owner based on the file descriptor. This API uses an asynchrono ...@@ -2445,6 +2368,7 @@ Changes the file owner based on the file descriptor. This API uses an asynchrono
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
let stat = fileio.statSync(path); let stat = fileio.statSync(path);
fileio.fchown(fd, stat.uid, stat.gid, function (err){ fileio.fchown(fd, stat.uid, stat.gid, function (err){
// Do something. // Do something.
...@@ -2471,6 +2395,7 @@ Synchronously changes the file owner based on the file descriptor. ...@@ -2471,6 +2395,7 @@ Synchronously changes the file owner based on the file descriptor.
**Example** **Example**
```js ```js
let fd = fileio.openSync(path);
let stat = fileio.statSync(path); let stat = fileio.statSync(path);
fileio.fchownSync(fd, stat.uid, stat.gid); fileio.fchownSync(fd, stat.uid, stat.gid);
``` ```
...@@ -2854,7 +2779,7 @@ Closes the stream. This API uses a promise to return the result. ...@@ -2854,7 +2779,7 @@ Closes the stream. This API uses a promise to return the result.
```js ```js
let ss= fileio.createStreamSync(path, "r+"); let ss= fileio.createStreamSync(path, "r+");
ss.close().then(function(){ ss.close().then(function(){
console.info("Stream closed"); console.info("File stream closed");
}).catch(function(err){ }).catch(function(err){
console.info("Failed to close the file stream. Error:"+ err); console.info("Failed to close the file stream. Error:"+ err);
}); });
...@@ -3102,7 +3027,7 @@ Reads data from the stream. This API uses a promise to return the result. ...@@ -3102,7 +3027,7 @@ Reads data from the stream. This API uses a promise to return the result.
```js ```js
let ss = fileio.createStreamSync(path, "r+"); let ss = fileio.createStreamSync(path, "r+");
ss.read(new ArrayBuffer(4096), {offset: 1, length: 5, position: 5}).then(function (readout){ ss.read(new ArrayBuffer(4096), {offset: 1, length: 5, position: 5}).then(function (readOut){
console.info("Read data successfully"); console.info("Read data successfully");
console.log(String.fromCharCode.apply(null, new Uint8Array(readOut.buffer))); console.log(String.fromCharCode.apply(null, new Uint8Array(readOut.buffer)));
}).catch(function(err){ }).catch(function(err){
...@@ -3179,7 +3104,7 @@ Synchronously reads data from the stream. ...@@ -3179,7 +3104,7 @@ Synchronously reads data from the stream.
## Dir ## Dir
Manages directories. Before calling a method of the **Dir** class, use the [opendir()](#fileioopendir) method synchronously or asynchronously to create a **Dir** instance. Manages directories. Before calling a method of the **Dir** class, use the **opendir()** method synchronously or asynchronously to create a **Dir** instance.
### read ### read
...@@ -3449,7 +3374,7 @@ Checks whether a directory entry is a socket. ...@@ -3449,7 +3374,7 @@ Checks whether a directory entry is a socket.
**Example** **Example**
```js ```js
let dir = fileio.opendirSync(dpath); let dir = fileio.opendirSync(path);
let isSocket = dir.readSync().isSocket(); let isSocket = dir.readSync().isSocket();
``` ```
......
en/application-dev/reference/apis/js-apis-securityLabel.md
浏览文件 @ 8bb856a6
...@@ -13,12 +13,15 @@ import securityLabel from '@ohos.securityLabel'; ...@@ -13,12 +13,15 @@ import securityLabel from '@ohos.securityLabel';
## Usage ## Usage
Before using the APIs provided by this module to perform operations on a file or directory, obtain the path of the application sandbox. For details, see [getOrCreateLocalDir of the Context module](js-apis-Context.md). Before using the APIs provided by this module to perform operations on a file or directory, obtain the path of the application sandbox as follows:
```js ```js
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let context = featureAbility.getContext(); let context = featureAbility.getContext();
let path = context.getFilesDir(); let path = '';
context.getFilesDir().then((data) => {
path = data;
})
``` ```
## securityLabel.setSecurityLabel ## securityLabel.setSecurityLabel
......
en/application-dev/reference/apis/js-apis-storage-statistics.md
浏览文件 @ 8bb856a6
...@@ -470,7 +470,7 @@ This is a system API and cannot be called by third-party applications. ...@@ -470,7 +470,7 @@ This is a system API and cannot be called by third-party applications.
| Name | Type | Mandatory| Description| | Name | Type | Mandatory| Description|
| ---------- | ------ | ---- | ---- | | ---------- | ------ | ---- | ---- |
| userId | string | No | User ID.<br>Value:<br>-&nbsp; Set this parameter to the ID of the user to be queried.<br>-&nbsp; If no value is specified, information about the current user is queried.| | userId | number | No | User ID.<br>Value:<br>-&nbsp; Set this parameter to the ID of the user to be queried.<br>-&nbsp; If no value is specified, information about the current user is queried.|
**Return value** **Return value**
...@@ -481,7 +481,7 @@ This is a system API and cannot be called by third-party applications. ...@@ -481,7 +481,7 @@ This is a system API and cannot be called by third-party applications.
**Example** **Example**
```js ```js
let userId = ""; let userId = 1;
storageStatistics.getUserStorageStats(userId).then(function(StorageStats){ storageStatistics.getUserStorageStats(userId).then(function(StorageStats){
console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats)); console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));
}).catch(function(err){ }).catch(function(err){
...@@ -507,13 +507,13 @@ This is a system API and cannot be called by third-party applications. ...@@ -507,13 +507,13 @@ This is a system API and cannot be called by third-party applications.
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| ---------- | ------------------------------------ | ---- | -------------------------- | | ---------- | ------------------------------------ | ---- | -------------------------- |
| userId | string | No | User ID.<br>Value:<br>-&nbsp; Set this parameter to the ID of the user to be queried.<br>-&nbsp; If no value is specified, information about the current user is queried. | | userId | number | No | User ID.<br>Value:<br>-&nbsp; Set this parameter to the ID of the user to be queried.<br>-&nbsp; If no value is specified, information about the current user is queried. |
| callback | callback:AsyncCallback&lt;[StorageStats](#StorageStats)&gt; | Yes | Callback invoked to return the information obtained.| | callback | callback:AsyncCallback&lt;[StorageStats](#StorageStats)&gt; | Yes | Callback invoked to return the information obtained.|
**Example** **Example**
```js ```js
let userId = ""; let userId = 1;
storageStatistics.getUserStorageStats(userId, function(error, StorageStats){ storageStatistics.getUserStorageStats(userId, function(error, StorageStats){
// Do something. // Do something.
console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats)); console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或