Skip to content

D
Docs

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

通知 159
Star 292
Fork 28
D
Docs

体验新版 GitCode，发现更多精彩内容 >>

未验证 提交 d77c6d2a 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!3908 update fileio api 

Merge pull request !3908 from zhangxingxia/master
上级 94965bfc 881d970c
隐藏空白更改
内联 并排
Showing with 316 addition and 311 deletion
zh-cn/application-dev/reference/apis/js-apis-fileio.md
浏览文件 @ d77c6d2a
...@@ -3,6 +3,8 @@ ...@@ -3,6 +3,8 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
该模块提供文件存储相关的常用功能：向应用程序提供用于IO的JS接口，包括用于管理文件的基本文件接口，用于管理目录的基本目录接口，用于获取文件信息的统计接口，用于流式读写文件的流式接口。
## 导入模块 ## 导入模块
```js ```js
...@@ -10,11 +12,6 @@ import fileio from '@ohos.fileio'; ...@@ -10,11 +12,6 @@ import fileio from '@ohos.fileio';
``` ```
## 权限列表
无
## 使用说明 ## 使用说明
使用该功能模块对文件/目录进行操作前，需要先获取其绝对路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 使用该功能模块对文件/目录进行操作前，需要先获取其绝对路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。
...@@ -44,17 +41,19 @@ stat(path: string): Promise<Stat> ...@@ -44,17 +41,19 @@ stat(path: string): Promise<Stat>
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待获取文件的绝对路径。 | | path | string | 是 | 待获取文件的绝对路径。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------- | ---------- | | ---------------------------- | ---------- |
| Promise<[Stat](#stat)> | 表示文件的具体信息。 | | Promise<[Stat](#stat)> | 表示文件的具体信息。 |
- 示例： **示例：**
```js ```js
fileio.stat(path).then(function(stat){ fileio.stat(path).then(function(stat){
console.info("getFileInfo successfully:"+ JSON.stringify(stat)); console.info("getFileInfo successfully:"+ JSON.stringify(stat));
...@@ -72,13 +71,13 @@ stat(path:string, callback:AsyncCallback<Stat>): void ...@@ -72,13 +71,13 @@ stat(path:string, callback:AsyncCallback<Stat>): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------- | ---- | --------------- | | -------- | ---------------------------------- | ---- | --------------- |
| path | string | 是 | 待获取文件的绝对路径。 | | path | string | 是 | 待获取文件的绝对路径。 |
| callback | AsyncCallback<[Stat](#stat)> | 是 | 异步获取文件的信息之后的回调。 | | callback | AsyncCallback<[Stat](#stat)> | 是 | 异步获取文件的信息之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.stat(path, function (err, stat) { fileio.stat(path, function (err, stat) {
// example code in Stat // example code in Stat
...@@ -94,18 +93,18 @@ statSync(path:string): Stat ...@@ -94,18 +93,18 @@ statSync(path:string): Stat
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待获取文件的绝对路径。 | | path | string | 是 | 待获取文件的绝对路径。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------- | ---------- | | ------------- | ---------- |
| [Stat](#stat) | 表示文件的具体信息。 | | [Stat](#stat) | 表示文件的具体信息。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(path); let stat = fileio.statSync(path);
// example code in Stat // example code in Stat
...@@ -120,17 +119,17 @@ opendir(path: string): Promise<Dir> ...@@ -120,17 +119,17 @@ opendir(path: string): Promise<Dir>
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------- | | ---- | ------ | ---- | ------------- |
| path | string | 是 | 待打开文件目录的绝对路径。 | | path | string | 是 | 待打开文件目录的绝对路径。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| -------------------------- | -------- | | -------------------------- | -------- |
| Promise<[Dir](#dir)> | 返回Dir对象。 | | Promise<[Dir](#dir)> | 返回Dir对象。 |
- 示例： **示例：**
```js ```js
fileio.opendir(path).then(function(dir){ fileio.opendir(path).then(function(dir){
console.info("opendir successfully:"+ JSON.stringify(dir)); console.info("opendir successfully:"+ JSON.stringify(dir));
...@@ -148,13 +147,14 @@ opendir(path: string, callback: AsyncCallback<Dir>): void ...@@ -148,13 +147,14 @@ opendir(path: string, callback: AsyncCallback<Dir>): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------- | ---- | -------------- | | -------- | -------------------------------- | ---- | -------------- |
| path | string | 是 | 待打开文件目录的绝对路径。 | | path | string | 是 | 待打开文件目录的绝对路径。 |
| callback | AsyncCallback<[Dir](#dir)> | 是 | 异步打开文件目录之后的回调。 | | callback | AsyncCallback<[Dir](#dir)> | 是 | 异步打开文件目录之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.opendir(path, function (err, dir) { fileio.opendir(path, function (err, dir) {
// example code in Dir struct // example code in Dir struct
...@@ -172,17 +172,18 @@ opendirSync(path: string): Dir ...@@ -172,17 +172,18 @@ opendirSync(path: string): Dir
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------- | | ---- | ------ | ---- | ------------- |
| path | string | 是 | 待打开文件目录的绝对路径。 | | path | string | 是 | 待打开文件目录的绝对路径。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ----------- | -------- | | ----------- | -------- |
| [Dir](#dir) | 返回Dir对象。 | | [Dir](#dir) | 返回Dir对象。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
// example code in Dir struct // example code in Dir struct
...@@ -198,18 +199,19 @@ access(path: string, mode?: number): Promise<void> ...@@ -198,18 +199,19 @@ access(path: string, mode?: number): Promise<void>
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数：. **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待访问文件的绝对路径。 | | path | string | 是 | 待访问文件的绝对路径。 |
| mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。<br/>确认当前进程是否具有对应权限：<br/>-&nbsp;0：确认文件是否存在。<br/>-&nbsp;1：确认当前进程是否具有可执行权限。<br/>-&nbsp;2：确认当前进程是否具有写权限。<br/>-&nbsp;4：确认当前进程是否具有读权限。 | | mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。<br/>确认当前进程是否具有对应权限：<br/>-&nbsp;0：确认文件是否存在。<br/>-&nbsp;1：确认当前进程是否具有可执行权限。<br/>-&nbsp;2：确认当前进程是否具有写权限。<br/>-&nbsp;4：确认当前进程是否具有读权限。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.access(path).then(function() { fileio.access(path).then(function() {
console.info("access successfully"); console.info("access successfully");
...@@ -227,14 +229,14 @@ access(path: string, mode: number, callback: AsyncCallback&lt;void&gt;): void ...@@ -227,14 +229,14 @@ access(path: string, mode: number, callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ---------------------------------------- | | -------- | ------------------------- | ---- | ---------------------------------------- |
| path | string | 是 | 待访问文件的绝对路径。 | | path | string | 是 | 待访问文件的绝对路径。 |
| mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。<br/>确认当前进程是否具有对应权限：<br/>-&nbsp;0：确认文件是否存在。<br/>-&nbsp;1：确认当前进程是否具有可执行权限。<br/>-&nbsp;2：确认当前进程是否具有写权限。<br/>-&nbsp;4：确认当前进程是否具有读权限。 | | mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。<br/>确认当前进程是否具有对应权限：<br/>-&nbsp;0：确认文件是否存在。<br/>-&nbsp;1：确认当前进程是否具有可执行权限。<br/>-&nbsp;2：确认当前进程是否具有写权限。<br/>-&nbsp;4：确认当前进程是否具有读权限。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步检查当前进程是否可访问某文件之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步检查当前进程是否可访问某文件之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.access(path, function (err) { fileio.access(path, function (err) {
// do something // do something
...@@ -250,13 +252,13 @@ accessSync(path: string, mode?: number): void ...@@ -250,13 +252,13 @@ accessSync(path: string, mode?: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待访问文件的绝对路径。 | | path | string | 是 | 待访问文件的绝对路径。 |
| mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。<br/>确认当前进程是否具有对应权限：<br/>-&nbsp;0：确认文件是否存在。<br/>-&nbsp;1：确认当前进程是否具有可执行权限。<br/>-&nbsp;2：确认当前进程是否具有写权限。<br/>-&nbsp;4：确认当前进程是否具有读权限。 | | mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。<br/>确认当前进程是否具有对应权限：<br/>-&nbsp;0：确认文件是否存在。<br/>-&nbsp;1：确认当前进程是否具有可执行权限。<br/>-&nbsp;2：确认当前进程是否具有写权限。<br/>-&nbsp;4：确认当前进程是否具有读权限。 |
- 示例： **示例：**
```js ```js
try { try {
fileio.accessSync(path); fileio.accessSync(path);
...@@ -274,17 +276,17 @@ close(fd: number):Promise&lt;void&gt; ...@@ -274,17 +276,17 @@ close(fd: number):Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待关闭文件的文件描述符。 | | fd | number | 是 | 待关闭文件的文件描述符。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path); let fd = fileio.openSync(path);
fileio.close(fd).then(function(){ fileio.close(fd).then(function(){
...@@ -303,13 +305,13 @@ close(fd: number, callback:AsyncCallback&lt;void&gt;): void ...@@ -303,13 +305,13 @@ close(fd: number, callback:AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------ | | -------- | ------------------------- | ---- | ------------ |
| fd | number | 是 | 待关闭文件的文件描述符。 | | fd | number | 是 | 待关闭文件的文件描述符。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步关闭文件之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步关闭文件之后的回调。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path); let fd = fileio.openSync(path);
fileio.close(fd, function (err) { fileio.close(fd, function (err) {
...@@ -326,12 +328,12 @@ closeSync(fd: number): void ...@@ -326,12 +328,12 @@ closeSync(fd: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待关闭文件的文件描述符。 | | fd | number | 是 | 待关闭文件的文件描述符。 |
- 示例： **示例：**
```js ```js
fileio.closeSync(fd); fileio.closeSync(fd);
``` ```
...@@ -345,12 +347,12 @@ close(): Promise&lt;void&gt; ...@@ -345,12 +347,12 @@ close(): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.close().then(function(){ fileio.close().then(function(){
console.info("close file stream successfully"); console.info("close file stream successfully");
...@@ -368,12 +370,12 @@ close(callback: AsyncCallback&lt;void&gt;): void ...@@ -368,12 +370,12 @@ close(callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------- | | -------- | ------------------------- | ---- | ------------- |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步关闭文件流之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步关闭文件流之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.close(function(err){ fileio.close(function(err){
// do something // do something
...@@ -389,19 +391,19 @@ copyFile(src:string | number, dest:string | number, mode?:number):Promise&lt;voi ...@@ -389,19 +391,19 @@ copyFile(src:string | number, dest:string | number, mode?:number):Promise&lt;voi
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | -------------------------- | ---- | ---------------------------------------- | | ---- | -------------------------- | ---- | ---------------------------------------- |
| src | string&nbsp;\|&nbsp;number | 是 | 待复制文件的路径或待复制文件的描述符。 | | src | string&nbsp;\|&nbsp;number | 是 | 待复制文件的路径或待复制文件的描述符。 |
| dest | string&nbsp;\|&nbsp;number | 是 | 目标文件路径或目标文件描述符。 | | dest | string&nbsp;\|&nbsp;number | 是 | 目标文件路径或目标文件描述符。 |
| mode | number | 否 | mode提供覆盖文件的选项，当前仅支持0，且默认为0。<br/>0：完全覆盖目标文件，未覆盖部分将被裁切掉。 | | mode | number | 否 | mode提供覆盖文件的选项，当前仅支持0，且默认为0。<br/>0：完全覆盖目标文件，未覆盖部分将被裁切掉。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.copyFile(src, dest).then(function(){ fileio.copyFile(src, dest).then(function(){
console.info("copyFile successfully"); console.info("copyFile successfully");
...@@ -419,7 +421,7 @@ copyFile(src: string | number, dest: string | number, mode: number, callback: As ...@@ -419,7 +421,7 @@ copyFile(src: string | number, dest: string | number, mode: number, callback: As
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------- | ---- | ---------------------------------------- | | -------- | -------------------------- | ---- | ---------------------------------------- |
| src | string&nbsp;\|&nbsp;number | 是 | 待复制文件的路径或待复制文件的描述符。 | | src | string&nbsp;\|&nbsp;number | 是 | 待复制文件的路径或待复制文件的描述符。 |
...@@ -427,7 +429,7 @@ copyFile(src: string | number, dest: string | number, mode: number, callback: As ...@@ -427,7 +429,7 @@ copyFile(src: string | number, dest: string | number, mode: number, callback: As
| mode | number | 否 | mode提供覆盖文件的选项，当前仅支持0，且默认为0。<br/>0：完全覆盖目标文件，未覆盖部分将被裁切掉。 | | mode | number | 否 | mode提供覆盖文件的选项，当前仅支持0，且默认为0。<br/>0：完全覆盖目标文件，未覆盖部分将被裁切掉。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步复制文件之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步复制文件之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.copyFile(src, dest, function (err) { fileio.copyFile(src, dest, function (err) {
// do something // do something
...@@ -443,14 +445,14 @@ copyFileSync(src: string | number, dest: string | number, mode?: number): void ...@@ -443,14 +445,14 @@ copyFileSync(src: string | number, dest: string | number, mode?: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | -------------------------- | ---- | ---------------------------------------- | | ---- | -------------------------- | ---- | ---------------------------------------- |
| src | string&nbsp;\|&nbsp;number | 是 | 待复制文件的路径或待复制文件的描述符。 | | src | string&nbsp;\|&nbsp;number | 是 | 待复制文件的路径或待复制文件的描述符。 |
| dest | string&nbsp;\|&nbsp;number | 是 | 目标文件路径或目标文件描述符。 | | dest | string&nbsp;\|&nbsp;number | 是 | 目标文件路径或目标文件描述符。 |
| mode | number | 否 | mode提供覆盖文件的选项，当前仅支持0，且默认为0。<br/>0：完全覆盖目标文件，未覆盖部分将被裁切掉。 | | mode | number | 否 | mode提供覆盖文件的选项，当前仅支持0，且默认为0。<br/>0：完全覆盖目标文件，未覆盖部分将被裁切掉。 |
- 示例： **示例：**
```js ```js
fileio.copyFileSync(src, dest); fileio.copyFileSync(src, dest);
``` ```
...@@ -464,18 +466,18 @@ mkdir(path:string, mode?: number): Promise&lt;void&gt; ...@@ -464,18 +466,18 @@ mkdir(path:string, mode?: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待创建目录的绝对路径。 | | path | string | 是 | 待创建目录的绝对路径。 |
| mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。<br/>-&nbsp;0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。<br/>-&nbsp;0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.mkdir(path).then(function() { fileio.mkdir(path).then(function() {
console.info("mkdir successfully"); console.info("mkdir successfully");
...@@ -493,14 +495,14 @@ mkdir(path: string, mode: number, callback: AsyncCallback&lt;void&gt;): void ...@@ -493,14 +495,14 @@ mkdir(path: string, mode: number, callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ---------------------------------------- | | -------- | ------------------------- | ---- | ---------------------------------------- |
| path | string | 是 | 待创建目录的绝对路径。 | | path | string | 是 | 待创建目录的绝对路径。 |
| mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。<br/>-&nbsp;0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。<br/>-&nbsp;0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步创建目录操作完成之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步创建目录操作完成之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.mkdir(path, function(err) { fileio.mkdir(path, function(err) {
console.info("mkdir successfully"); console.info("mkdir successfully");
...@@ -516,13 +518,13 @@ mkdirSync(path: string, mode?: number): void ...@@ -516,13 +518,13 @@ mkdirSync(path: string, mode?: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待创建目录的绝对路径。 | | path | string | 是 | 待创建目录的绝对路径。 |
| mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。<br/>-&nbsp;0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。<br/>-&nbsp;0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
- 示例： **示例：**
```js ```js
fileio.mkdirSync(path); fileio.mkdirSync(path);
``` ```
...@@ -536,19 +538,19 @@ open(path: string, flags?: number, mode?: number): Promise&lt;number&gt; ...@@ -536,19 +538,19 @@ open(path: string, flags?: number, mode?: number): Promise&lt;number&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | ------ | ---- | ---------------------------------------- | | ----- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
| flags | number | 否 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：<br/>-&nbsp;0o0：只读打开。<br/>-&nbsp;0o1：只写打开。<br/>-&nbsp;0o2：读写打开。<br/>同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：<br/>-&nbsp;0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数&nbsp;mode。<br/>-&nbsp;0o200：如果追加了0o100选项，且文件已经存在，则出错。<br/>-&nbsp;0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。<br/>-&nbsp;0o2000：以追加方式打开，后续写将追加到文件末尾。<br/>-&nbsp;0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续&nbsp;IO&nbsp;进行非阻塞操作。<br/>-&nbsp;0o200000：如果path指向目录，则出错。<br/>-&nbsp;0o400000：如果path指向符号链接，则出错。<br/>-&nbsp;0o4010000：以同步IO的方式打开文件。 | | flags | number | 否 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：<br/>-&nbsp;0o0：只读打开。<br/>-&nbsp;0o1：只写打开。<br/>-&nbsp;0o2：读写打开。<br/>同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：<br/>-&nbsp;0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数&nbsp;mode。<br/>-&nbsp;0o200：如果追加了0o100选项，且文件已经存在，则出错。<br/>-&nbsp;0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。<br/>-&nbsp;0o2000：以追加方式打开，后续写将追加到文件末尾。<br/>-&nbsp;0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续&nbsp;IO&nbsp;进行非阻塞操作。<br/>-&nbsp;0o200000：如果path指向目录，则出错。<br/>-&nbsp;0o400000：如果path指向符号链接，则出错。<br/>-&nbsp;0o4010000：以同步IO的方式打开文件。 |
| mode | number | 否 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。<br/>-&nbsp;0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 否 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。<br/>-&nbsp;0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ----------- | | --------------------- | ----------- |
| Promise&lt;number&gt; | 打开文件的文件描述符。 | | Promise&lt;number&gt; | 打开文件的文件描述符。 |
- 示例： **示例：**
```js ```js
fileio.open(path, 0o1, 0o0200).then(function(number){ fileio.open(path, 0o1, 0o0200).then(function(number){
console.info("open file successfully"); console.info("open file successfully");
...@@ -566,7 +568,7 @@ open(path: string, flags: number, mode: number, callback: AsyncCallback&lt;numbe ...@@ -566,7 +568,7 @@ open(path: string, flags: number, mode: number, callback: AsyncCallback&lt;numbe
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------- | ---- | ---------------------------------------- | | -------- | ------------------------------- | ---- | ---------------------------------------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
...@@ -574,7 +576,7 @@ open(path: string, flags: number, mode: number, callback: AsyncCallback&lt;numbe ...@@ -574,7 +576,7 @@ open(path: string, flags: number, mode: number, callback: AsyncCallback&lt;numbe
| mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。<br/>-&nbsp;0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。<br/>-&nbsp;0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
| callback | AsyncCallback&nbsp;&lt;void&gt; | 是 | 异步打开文件之后的回调。 | | callback | AsyncCallback&nbsp;&lt;void&gt; | 是 | 异步打开文件之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.open(path, 0, function(err, fd) { fileio.open(path, 0, function(err, fd) {
// do something // do something
...@@ -590,19 +592,19 @@ openSync(path:string, flags?:number, mode?:number): number ...@@ -590,19 +592,19 @@ openSync(path:string, flags?:number, mode?:number): number
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | ------ | ---- | ---------------------------------------- | | ----- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
| flags | number | 否 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：<br/>-&nbsp;0o0：只读打开。<br/>-&nbsp;0o1：只写打开。<br/>-&nbsp;0o2：读写打开。<br/>同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：<br/>-&nbsp;0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数&nbsp;mode。<br/>-&nbsp;0o200：如果追加了0o100选项，且文件已经存在，则出错。<br/>-&nbsp;0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。<br/>-&nbsp;0o2000：以追加方式打开，后续写将追加到文件末尾。<br/>-&nbsp;0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续&nbsp;IO&nbsp;进行非阻塞操作。<br/>-&nbsp;0o200000：如果path指向目录，则出错。<br/>-&nbsp;0o400000：如果path指向符号链接，则出错。<br/>-&nbsp;0o4010000：以同步IO的方式打开文件。 | | flags | number | 否 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：<br/>-&nbsp;0o0：只读打开。<br/>-&nbsp;0o1：只写打开。<br/>-&nbsp;0o2：读写打开。<br/>同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：<br/>-&nbsp;0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数&nbsp;mode。<br/>-&nbsp;0o200：如果追加了0o100选项，且文件已经存在，则出错。<br/>-&nbsp;0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。<br/>-&nbsp;0o2000：以追加方式打开，后续写将追加到文件末尾。<br/>-&nbsp;0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续&nbsp;IO&nbsp;进行非阻塞操作。<br/>-&nbsp;0o200000：如果path指向目录，则出错。<br/>-&nbsp;0o400000：如果path指向符号链接，则出错。<br/>-&nbsp;0o4010000：以同步IO的方式打开文件。 |
| mode | number | 否 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。<br/>-&nbsp;0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。<br/>创建出的文件权限受umask影响，umask随进程启动确定，其修改当前不开放。 | | mode | number | 否 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。<br/>-&nbsp;0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。<br/>创建出的文件权限受umask影响，umask随进程启动确定，其修改当前不开放。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------ | ----------- | | ------ | ----------- |
| number | 打开文件的文件描述符。 | | number | 打开文件的文件描述符。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path); let fd = fileio.openSync(path);
``` ```
...@@ -620,19 +622,20 @@ read(fd: number, buffer: ArrayBuffer, options?: { ...@@ -620,19 +622,20 @@ read(fd: number, buffer: ArrayBuffer, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------- | ---- | ---------------------------------------- | | ------- | ----------- | ---- | ------------------------------------------------------------ |
| fd | number | 是 | 待读取文件的文件描述符。 | | fd | number | 是 | 待读取文件的文件描述符。 |
| buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 | | buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>约束：offset+length<=buffer.size。 |
**返回值：**
- 返回值：
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------- | ------ | | ---------------------------------- | ------ |
| Promise&lt;[ReadOut](#readout)&gt; | 读取的结果。 | | Promise&lt;[ReadOut](#readout)&gt; | 读取的结果。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path, 0o2); let fd = fileio.openSync(path, 0o2);
let buf = new ArrayBuffer(4096); let buf = new ArrayBuffer(4096);
...@@ -657,15 +660,15 @@ read(fd: number, buffer: ArrayBuffer, options: { ...@@ -657,15 +660,15 @@ read(fd: number, buffer: ArrayBuffer, options: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- | | -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| fd | number | 是 | 待读取文件的文件描述符。 | | fd | number | 是 | 待读取文件的文件描述符。 |
| buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 | | buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>约束：offset+length<=buffer.size。 |
| callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是 | 异步读取数据之后的回调。 | | callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是 | 异步读取数据之后的回调。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path, 0o2); let fd = fileio.openSync(path, 0o2);
let buf = new ArrayBuffer(4096); let buf = new ArrayBuffer(4096);
...@@ -690,19 +693,19 @@ readSync(fd: number, buffer: ArrayBuffer, options?: { ...@@ -690,19 +693,19 @@ readSync(fd: number, buffer: ArrayBuffer, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------- | ---- | ---------------------------------------- | | ------- | ----------- | ---- | ---------------------------------------- |
| fd | number | 是 | 待读取文件的文件描述符。 | | fd | number | 是 | 待读取文件的文件描述符。 |
| buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 | | buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>约束：offset+length<=buffer.size。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------ | -------- | | ------ | -------- |
| number | 实际读取的长度。 | | number | 实际读取的长度。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path, 0o2); let fd = fileio.openSync(path, 0o2);
let buf = new ArrayBuffer(4096); let buf = new ArrayBuffer(4096);
...@@ -718,17 +721,17 @@ rmdir(path: string): Promise&lt;void&gt; ...@@ -718,17 +721,17 @@ rmdir(path: string): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待删除目录的绝对路径。 | | path | string | 是 | 待删除目录的绝对路径。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.rmdir(path).then(function() { fileio.rmdir(path).then(function() {
console.info("rmdir successfully"); console.info("rmdir successfully");
...@@ -746,13 +749,13 @@ rmdir(path: string, callback:AsyncCallback&lt;void&gt;): void ...@@ -746,13 +749,13 @@ rmdir(path: string, callback:AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------ | | -------- | ------------------------- | ---- | ------------ |
| path | string | 是 | 待删除目录的绝对路径。 | | path | string | 是 | 待删除目录的绝对路径。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步删除目录之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步删除目录之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.rmdir(path, function(err){ fileio.rmdir(path, function(err){
// do something // do something
...@@ -769,12 +772,12 @@ rmdirSync(path: string): void ...@@ -769,12 +772,12 @@ rmdirSync(path: string): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待删除目录的绝对路径。 | | path | string | 是 | 待删除目录的绝对路径。 |
- 示例： **示例：**
```js ```js
fileio.rmdirSync(path); fileio.rmdirSync(path);
``` ```
...@@ -788,17 +791,17 @@ unlink(path:string): Promise&lt;void&gt; ...@@ -788,17 +791,17 @@ unlink(path:string): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待删除文件的绝对路径。 | | path | string | 是 | 待删除文件的绝对路径。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.unlink(path).then(function(){ fileio.unlink(path).then(function(){
console.info("remove file successfully"); console.info("remove file successfully");
...@@ -816,13 +819,13 @@ unlink(path:string, callback:AsyncCallback&lt;void&gt;): void ...@@ -816,13 +819,13 @@ unlink(path:string, callback:AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------ | | -------- | ------------------------- | ---- | ------------ |
| path | string | 是 | 待删除文件的绝对路径。 | | path | string | 是 | 待删除文件的绝对路径。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步删除文件之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步删除文件之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.unlink(path, function(err) { fileio.unlink(path, function(err) {
console.info("remove file successfully"); console.info("remove file successfully");
...@@ -838,12 +841,12 @@ unlinkSync(path: string): void ...@@ -838,12 +841,12 @@ unlinkSync(path: string): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待删除文件的绝对路径。 | | path | string | 是 | 待删除文件的绝对路径。 |
- 示例： **示例：**
```js ```js
fileio.unlinkSync(path); fileio.unlinkSync(path);
``` ```
...@@ -862,19 +865,19 @@ write(fd: number, buffer: ArrayBuffer | string, options?: { ...@@ -862,19 +865,19 @@ write(fd: number, buffer: ArrayBuffer | string, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------- | ---- | ---------------------------------------- | | ------- | ------------------------------- | ---- | ---------------------------------------- |
| fd | number | 是 | 待写入文件的文件描述符。 | | fd | number | 是 | 待写入文件的文件描述符。 |
| buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 | | buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>约束：offset+length<=buffer.size。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | -------- | | --------------------- | -------- |
| Promise&lt;number&gt; | 实际写入的长度。 | | Promise&lt;number&gt; | 实际写入的长度。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(fpath, 0o100 | 0o2, 0o666); let fd = fileio.openSync(fpath, 0o100 | 0o2, 0o666);
fileio.write(fd, "hello, world").then(function(number){ fileio.write(fd, "hello, world").then(function(number){
...@@ -898,15 +901,15 @@ write(fd: number, buffer: ArrayBuffer | string, options: { ...@@ -898,15 +901,15 @@ write(fd: number, buffer: ArrayBuffer | string, options: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------- | ---- | ---------------------------------------- | | -------- | ------------------------------- | ---- | ---------------------------------------- |
| fd | number | 是 | 待写入文件的文件描述符。 | | fd | number | 是 | 待写入文件的文件描述符。 |
| buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 | | buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>约束：offset+length<=buffer.size。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 异步将数据写入完成后执行的回调函数。 | | callback | AsyncCallback&lt;number&gt; | 是 | 异步将数据写入完成后执行的回调函数。 |
- 示例： **示例：**
```js ```js
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) {
...@@ -930,19 +933,19 @@ writeSync(fd: number, buffer: ArrayBuffer | string, options?: { ...@@ -930,19 +933,19 @@ writeSync(fd: number, buffer: ArrayBuffer | string, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------- | ---- | ---------------------------------------- | | ------- | ------------------------------- | ---- | ---------------------------------------- |
| fd | number | 是 | 待写入文件的文件描述符。 | | fd | number | 是 | 待写入文件的文件描述符。 |
| buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 | | buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>约束：offset+length<=buffer.size。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------ | -------- | | ------ | -------- |
| number | 实际写入的长度。 | | number | 实际写入的长度。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path, 0o100 | 0o2, 0o666); let fd = fileio.openSync(path, 0o100 | 0o2, 0o666);
let num = fileio.writeSync(fd, "hello, world"); let num = fileio.writeSync(fd, "hello, world");
...@@ -957,18 +960,18 @@ hash(path: string, algorithm: string): Promise&lt;string&gt; ...@@ -957,18 +960,18 @@ hash(path: string, algorithm: string): Promise&lt;string&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | ---------------------------------------- | | --------- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待计算哈希值文件的绝对路径。 | | path | string | 是 | 待计算哈希值文件的绝对路径。 |
| algorithm | string | 是 | 哈希计算采用的算法。可选&nbsp;"md5"、"sha1"&nbsp;或&nbsp;"sha256"。建议采用安全强度更高的&nbsp;"sha256"。 | | algorithm | string | 是 | 哈希计算采用的算法。可选&nbsp;"md5"、"sha1"&nbsp;或&nbsp;"sha256"。建议采用安全强度更高的&nbsp;"sha256"。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | -------------------------- | | --------------------- | -------------------------- |
| Promise&lt;string&gt; | 文件的哈希值。表示为十六进制数字串，所有字母均大写。 | | Promise&lt;string&gt; | 文件的哈希值。表示为十六进制数字串，所有字母均大写。 |
- 示例： **示例：**
```js ```js
fileio.hash(path, "sha256").then(function(str){ fileio.hash(path, "sha256").then(function(str){
console.info("calculate file hash successfully:"+ str); console.info("calculate file hash successfully:"+ str);
...@@ -986,14 +989,14 @@ hash(path: string, algorithm: string, callback: AsyncCallback&lt;string&gt;): vo ...@@ -986,14 +989,14 @@ hash(path: string, algorithm: string, callback: AsyncCallback&lt;string&gt;): vo
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | --------------------------- | ---- | ---------------------------------------- | | --------- | --------------------------- | ---- | ---------------------------------------- |
| path | string | 是 | 待计算哈希值文件的绝对路径。 | | path | string | 是 | 待计算哈希值文件的绝对路径。 |
| algorithm | string | 是 | 哈希计算采用的算法。可选&nbsp;"md5"、"sha1"&nbsp;或&nbsp;"sha256"。建议采用安全强度更高的&nbsp;"sha256"。 | | algorithm | string | 是 | 哈希计算采用的算法。可选&nbsp;"md5"、"sha1"&nbsp;或&nbsp;"sha256"。建议采用安全强度更高的&nbsp;"sha256"。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 异步计算文件哈希操之后的回调函数（其中给定文件哈希值表示为十六进制数字串，所有字母均大写）。 | | callback | AsyncCallback&lt;string&gt; | 是 | 异步计算文件哈希操之后的回调函数（其中给定文件哈希值表示为十六进制数字串，所有字母均大写）。 |
- 示例： **示例：**
```js ```js
fileio.hash(fpath, "sha256", function(err, hashStr) { fileio.hash(fpath, "sha256", function(err, hashStr) {
if (hashStr) { if (hashStr) {
...@@ -1011,18 +1014,18 @@ chmod(path: string, mode: number):Promise&lt;void&gt; ...@@ -1011,18 +1014,18 @@ chmod(path: string, mode: number):Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待改变文件权限的绝对路径。 | | path | string | 是 | 待改变文件权限的绝对路径。 |
| mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.chmod(path, mode).then(function() { fileio.chmod(path, mode).then(function() {
console.info("chmod successfully"); console.info("chmod successfully");
...@@ -1040,14 +1043,14 @@ chmod(path: string, mode: number, callback: AsyncCallback&lt;void&gt;): void ...@@ -1040,14 +1043,14 @@ chmod(path: string, mode: number, callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ---------------------------------------- | | -------- | ------------------------- | ---- | ---------------------------------------- |
| path | string | 是 | 待改变文件权限的绝对路径。 | | path | string | 是 | 待改变文件权限的绝对路径。 |
| mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步改变文件权限之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步改变文件权限之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.chmod(path, mode, function (err) { fileio.chmod(path, mode, function (err) {
// do something // do something
...@@ -1063,13 +1066,13 @@ chmodSync(path: string, mode: number): void ...@@ -1063,13 +1066,13 @@ chmodSync(path: string, mode: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待改变文件权限的绝对路径。 | | path | string | 是 | 待改变文件权限的绝对路径。 |
| mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
- 示例： **示例：**
```js ```js
fileio.chmodSync(fpath, mode); fileio.chmodSync(fpath, mode);
``` ```
...@@ -1083,17 +1086,17 @@ fstat(fd: number): Promise&lt;Stat&gt; ...@@ -1083,17 +1086,17 @@ fstat(fd: number): Promise&lt;Stat&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待获取文件的文件描述符。 | | fd | number | 是 | 待获取文件的文件描述符。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------- | ---------- | | ---------------------------- | ---------- |
| Promise&lt;[Stat](#stat)&gt; | 表示文件的具体信息。 | | Promise&lt;[Stat](#stat)&gt; | 表示文件的具体信息。 |
- 示例： **示例：**
```js ```js
fileio.fstat(fd).then(function(stat){ fileio.fstat(fd).then(function(stat){
console.info("fstat successfully:"+ JSON.stringify(stat)); console.info("fstat successfully:"+ JSON.stringify(stat));
...@@ -1111,13 +1114,13 @@ fstat(fd: number, callback: AsyncCallback&lt;Stat&gt;): void ...@@ -1111,13 +1114,13 @@ fstat(fd: number, callback: AsyncCallback&lt;Stat&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------- | ---- | ---------------- | | -------- | ---------------------------------- | ---- | ---------------- |
| fd | number | 是 | 待获取文件的文件描述符。 | | fd | number | 是 | 待获取文件的文件描述符。 |
| callback | AsyncCallback&lt;[Stat](#stat)&gt; | 是 | 异步获取文件状态信息之后的回调。 | | callback | AsyncCallback&lt;[Stat](#stat)&gt; | 是 | 异步获取文件状态信息之后的回调。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path); let fd = fileio.openSync(path);
fileio.fstat(fd, function (err) { fileio.fstat(fd, function (err) {
...@@ -1134,17 +1137,17 @@ fstatSync(fd: number): Stat ...@@ -1134,17 +1137,17 @@ fstatSync(fd: number): Stat
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待获取文件的文件描述符。 | | fd | number | 是 | 待获取文件的文件描述符。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------- | ---------- | | ------------- | ---------- |
| [Stat](#stat) | 表示文件的具体信息。 | | [Stat](#stat) | 表示文件的具体信息。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path); let fd = fileio.openSync(path);
let stat = fileio.fstatSync(fd); let stat = fileio.fstatSync(fd);
...@@ -1159,18 +1162,18 @@ ftruncate(fd: number, len?: number): Promise&lt;void&gt; ...@@ -1159,18 +1162,18 @@ ftruncate(fd: number, len?: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------- | | ---- | ------ | ---- | ---------------- |
| fd | number | 是 | 待截断文件的文件描述符。 | | fd | number | 是 | 待截断文件的文件描述符。 |
| len | number | 是 | 文件截断后的长度，以字节为单位。 | | len | number | 是 | 文件截断后的长度，以字节为单位。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
let fd = fileio.openSync(path); let fd = fileio.openSync(path);
fileio.ftruncate(fd, 5).then(function(err) { fileio.ftruncate(fd, 5).then(function(err) {
...@@ -1189,14 +1192,14 @@ ftruncate(fd: number, len: number, callback:AsyncCallback&lt;void&gt;): void ...@@ -1189,14 +1192,14 @@ ftruncate(fd: number, len: number, callback:AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ---------------- | | -------- | ------------------------- | ---- | ---------------- |
| fd | number | 是 | 待截断文件的文件描述符。 | | fd | number | 是 | 待截断文件的文件描述符。 |
| len | number | 是 | 文件截断后的长度，以字节为单位。 | | len | number | 是 | 文件截断后的长度，以字节为单位。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步截断文件的信息之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步截断文件的信息之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.ftruncate(fd, len, function(err){ fileio.ftruncate(fd, len, function(err){
// do something // do something
...@@ -1212,13 +1215,13 @@ ftruncateSync(fd: number, len?: number): void ...@@ -1212,13 +1215,13 @@ ftruncateSync(fd: number, len?: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------- | | ---- | ------ | ---- | ---------------- |
| fd | number | 是 | 待截断文件的文件描述符。 | | fd | number | 是 | 待截断文件的文件描述符。 |
| len | number | 否 | 文件截断后的长度，以字节为单位。 | | len | number | 否 | 文件截断后的长度，以字节为单位。 |
- 示例： **示例：**
```js ```js
fileio.ftruncateSync(fd, len); fileio.ftruncateSync(fd, len);
``` ```
...@@ -1232,18 +1235,18 @@ truncate(path: string, len?: number): Promise&lt;void&gt; ...@@ -1232,18 +1235,18 @@ truncate(path: string, len?: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------- | | ---- | ------ | ---- | ---------------- |
| path | string | 是 | 待截断文件的绝对路径。 | | path | string | 是 | 待截断文件的绝对路径。 |
| len | number | 是 | 文件截断后的长度，以字节为单位。 | | len | number | 是 | 文件截断后的长度，以字节为单位。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.truncate(path, len).then(function(){ fileio.truncate(path, len).then(function(){
console.info("truncate file successfully"); console.info("truncate file successfully");
...@@ -1261,14 +1264,14 @@ truncate(path: string, len: number, callback:AsyncCallback&lt;void&gt;): void ...@@ -1261,14 +1264,14 @@ truncate(path: string, len: number, callback:AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ---------------- | | -------- | ------------------------- | ---- | ---------------- |
| path | string | 是 | 待截断文件的绝对路径。 | | path | string | 是 | 待截断文件的绝对路径。 |
| len | number | 是 | 文件截断后的长度，以字节为单位。 | | len | number | 是 | 文件截断后的长度，以字节为单位。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步截断文件的信息之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步截断文件的信息之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.truncate(path, len, function(err){ fileio.truncate(path, len, function(err){
// do something // do something
...@@ -1284,13 +1287,13 @@ truncateSync(path: string, len?: number): void ...@@ -1284,13 +1287,13 @@ truncateSync(path: string, len?: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------- | | ---- | ------ | ---- | ---------------- |
| path | string | 是 | 待截断文件的绝对路径。 | | path | string | 是 | 待截断文件的绝对路径。 |
| len | number | 否 | 文件截断后的长度，以字节为单位。 | | len | number | 否 | 文件截断后的长度，以字节为单位。 |
- 示例： **示例：**
```js ```js
fileio.truncateSync(path, len); fileio.truncateSync(path, len);
``` ```
...@@ -1308,18 +1311,18 @@ readText(filePath: string, options?: { ...@@ -1308,18 +1311,18 @@ readText(filePath: string, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---------------------------------------- | | -------- | ------ | ---- | ---------------------------------------- |
| filePath | string | 是 | 待读取文件的绝对路径。 | | filePath | string | 是 | 待读取文件的绝对路径。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;encoding，string类型，当数据是&nbsp;string&nbsp;类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'，仅支持&nbsp;'utf-8'。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;encoding，string类型，当数据是&nbsp;string&nbsp;类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'，仅支持&nbsp;'utf-8'。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ---------- | | --------------------- | ---------- |
| Promise&lt;string&gt; | 返回读取文件的内容。 | | Promise&lt;string&gt; | 返回读取文件的内容。 |
- 示例： **示例：**
```js ```js
fileio.readText(path).then(function(str) { fileio.readText(path).then(function(str) {
console.info("readText successfully:"+ str); console.info("readText successfully:"+ str);
...@@ -1341,14 +1344,14 @@ readText(filePath: string, options: { ...@@ -1341,14 +1344,14 @@ readText(filePath: string, options: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------------------------------------- | | -------- | --------------------------- | ---- | ---------------------------------------- |
| filePath | string | 是 | 待读取文件的绝对路径。 | | filePath | string | 是 | 待读取文件的绝对路径。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;encoding，string类型，当数据是&nbsp;string&nbsp;类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'，仅支持&nbsp;'utf-8'。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;encoding，string类型，当数据是&nbsp;string&nbsp;类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'，仅支持&nbsp;'utf-8'。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 异步通过文本方式读取文件之后的回调。 | | callback | AsyncCallback&lt;string&gt; | 是 | 异步通过文本方式读取文件之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.readText(path, function(err, str){ fileio.readText(path, function(err, str){
// do something // do something
...@@ -1368,18 +1371,18 @@ readTextSync(filePath: string, options?: { ...@@ -1368,18 +1371,18 @@ readTextSync(filePath: string, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---------------------------------------- | | -------- | ------ | ---- | ---------------------------------------- |
| filePath | string | 是 | 待读取文件的绝对路径。 | | filePath | string | 是 | 待读取文件的绝对路径。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;encoding，string类型，当数据是&nbsp;string&nbsp;类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'，仅支持&nbsp;'utf-8'。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;encoding，string类型，当数据是&nbsp;string&nbsp;类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'，仅支持&nbsp;'utf-8'。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------ | -------------------- | | ------ | -------------------- |
| string | 返回读取文件的内容。 | | string | 返回读取文件的内容。 |
- 示例： **示例：**
```js ```js
let str = fileio.readTextSync(path, {position: 1, length: 3}); let str = fileio.readTextSync(path, {position: 1, length: 3});
``` ```
...@@ -1393,17 +1396,17 @@ lstat(path: string): Promise&lt;Stat&gt; ...@@ -1393,17 +1396,17 @@ lstat(path: string): Promise&lt;Stat&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------------- | | ---- | ------ | ---- | ----------------- |
| path | string | 是 | 目标文件的绝对路径，指向链接状态。 | | path | string | 是 | 目标文件的绝对路径，指向链接状态。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------- | ---------- | | ---------------------------- | ---------- |
| Promise&lt;[Stat](#stat)&gt; | 表示文件的具体信息。 | | Promise&lt;[Stat](#stat)&gt; | 表示文件的具体信息。 |
- 示例： **示例：**
```js ```js
fileio.lstat(path).then(function(stat){ fileio.lstat(path).then(function(stat){
console.info("get link status successfully:"+ number); console.info("get link status successfully:"+ number);
...@@ -1421,13 +1424,13 @@ lstat(path:string, callback:AsyncCallback&lt;Stat&gt;): void ...@@ -1421,13 +1424,13 @@ lstat(path:string, callback:AsyncCallback&lt;Stat&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------- | ---- | ----------------- | | -------- | ---------------------------------- | ---- | ----------------- |
| path | string | 是 | 目标文件的绝对路径，指向链接状态。 | | path | string | 是 | 目标文件的绝对路径，指向链接状态。 |
| callback | AsyncCallback&lt;[Stat](#stat)&gt; | 是 | 异步获取链接状态信息之后的回调。 | | callback | AsyncCallback&lt;[Stat](#stat)&gt; | 是 | 异步获取链接状态信息之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.lstat(path, function (err, stat) { fileio.lstat(path, function (err, stat) {
// do something // do something
...@@ -1443,17 +1446,17 @@ lstatSync(path:string): Stat ...@@ -1443,17 +1446,17 @@ lstatSync(path:string): Stat
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------------- | | ---- | ------ | ---- | ----------------- |
| path | string | 是 | 目标文件的绝对路径，指向链接状态。 | | path | string | 是 | 目标文件的绝对路径，指向链接状态。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------- | ---------- | | ------------- | ---------- |
| [Stat](#stat) | 表示文件的具体信息。 | | [Stat](#stat) | 表示文件的具体信息。 |
- 示例： **示例：**
```js ```js
let stat = fileio.lstatSync(path); let stat = fileio.lstatSync(path);
``` ```
...@@ -1471,18 +1474,18 @@ read(buffer: ArrayBuffer, options?: { ...@@ -1471,18 +1474,18 @@ read(buffer: ArrayBuffer, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------- | ---- | ------------------------------------------------------------ | | ------- | ----------- | ---- | ------------------------------------------------------------ |
| buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 | | buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>约束：offset+length<=buffer.size。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------- | ------ | | ---------------------------------- | ------ |
| Promise&lt;[ReadOut](#readout)&gt; | 读取的结果。 | | Promise&lt;[ReadOut](#readout)&gt; | 读取的结果。 |
- 示例： **示例：**
```js ```js
fileio.read(new ArrayBuffer(4096)).then(function(readout){ fileio.read(new ArrayBuffer(4096)).then(function(readout){
console.info("read file data successfully"); console.info("read file data successfully");
...@@ -1505,14 +1508,14 @@ read(buffer: ArrayBuffer, options: { ...@@ -1505,14 +1508,14 @@ read(buffer: ArrayBuffer, options: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- | | -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 | | buffer | ArrayBuffer | 是 | 用于保存读取到的文件数据的缓冲区。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>约束：offset+length<=buffer.size。 |
| callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是 | 异步从文件读取数据之后的回调。 | | callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是 | 异步从文件读取数据之后的回调。 |
- 示例 **示例：**
```js ```js
let buf = new ArrayBuffer(4096); let buf = new ArrayBuffer(4096);
fileio.read(buf, function (err, readOut) { fileio.read(buf, function (err, readOut) {
...@@ -1532,18 +1535,18 @@ rename(oldPath: string, newPath: string): Promise&lt;void&gt; ...@@ -1532,18 +1535,18 @@ rename(oldPath: string, newPath: string): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ------------------------ | | ------- | ------ | ---- | ------------------------ |
| oldPath | string | 是 | 目标文件的当前绝对路径。 | | oldPath | string | 是 | 目标文件的当前绝对路径。 |
| newPath | String | 是 | 目标文件的新绝对路径。 | | newPath | String | 是 | 目标文件的新绝对路径。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.rename(oldPath, newPath).then(function() { fileio.rename(oldPath, newPath).then(function() {
console.info("rename successfully"); console.info("rename successfully");
...@@ -1561,14 +1564,14 @@ rename(oldPath: string, newPath: string, callback: AsyncCallback&lt;void&gt;): v ...@@ -1561,14 +1564,14 @@ rename(oldPath: string, newPath: string, callback: AsyncCallback&lt;void&gt;): v
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------- | | -------- | ------------------------- | ---- | ------------- |
| oldPath | string | 是 | 目标文件的当前绝对路径。 | | oldPath | string | 是 | 目标文件的当前绝对路径。 |
| newPath | String | 是 | 目标文件的新绝对路径。 | | newPath | String | 是 | 目标文件的新绝对路径。 |
| Callback | AsyncCallback&lt;void&gt; | 是 | 异步重命名文件之后的回调。 | | Callback | AsyncCallback&lt;void&gt; | 是 | 异步重命名文件之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.rename(oldPath, newPath, function(err){ fileio.rename(oldPath, newPath, function(err){
}); });
...@@ -1583,13 +1586,13 @@ renameSync(oldPath: string, newPath: string): void ...@@ -1583,13 +1586,13 @@ renameSync(oldPath: string, newPath: string): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ------------ | | ------- | ------ | ---- | ------------ |
| oldPath | string | 是 | 目标文件的当前绝对路径。 | | oldPath | string | 是 | 目标文件的当前绝对路径。 |
| newPath | String | 是 | 目标文件的新绝对路径。 | | newPath | String | 是 | 目标文件的新绝对路径。 |
- 示例： **示例：**
```js ```js
fileio.renameSync(oldPath, newPath); fileio.renameSync(oldPath, newPath);
``` ```
...@@ -1603,17 +1606,17 @@ fsync(fd: number): Promise&lt;void&gt; ...@@ -1603,17 +1606,17 @@ fsync(fd: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待同步文件的文件描述符。 | | fd | number | 是 | 待同步文件的文件描述符。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.fsync(fd).then(function(){ fileio.fsync(fd).then(function(){
console.info("sync data successfully"); console.info("sync data successfully");
...@@ -1631,13 +1634,13 @@ fsync(fd: number, callback: AsyncCallback&lt;void&gt;): void ...@@ -1631,13 +1634,13 @@ fsync(fd: number, callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | --------------- | | -------- | ------------------------- | ---- | --------------- |
| fd | number | 是 | 待同步文件的文件描述符。 | | fd | number | 是 | 待同步文件的文件描述符。 |
| Callback | AsyncCallback&lt;void&gt; | 是 | 异步将文件数据同步之后的回调。 | | Callback | AsyncCallback&lt;void&gt; | 是 | 异步将文件数据同步之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.fsync(fd, function(err){ fileio.fsync(fd, function(err){
// do something // do something
...@@ -1653,12 +1656,12 @@ fsyncSync(fd: number): void ...@@ -1653,12 +1656,12 @@ fsyncSync(fd: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待同步文件的文件描述符。 | | fd | number | 是 | 待同步文件的文件描述符。 |
- 示例： **示例：**
```js ```js
fileio.fyncsSync(fd); fileio.fyncsSync(fd);
``` ```
...@@ -1672,17 +1675,17 @@ fdatasync(fd: number): Promise&lt;void&gt; ...@@ -1672,17 +1675,17 @@ fdatasync(fd: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待同步文件的文件描述符。 | | fd | number | 是 | 待同步文件的文件描述符。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果，本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果，本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.fdatasync(fd).then(function(err) { fileio.fdatasync(fd).then(function(err) {
console.info("sync data successfully"); console.info("sync data successfully");
...@@ -1700,13 +1703,13 @@ fdatasync(fd: number, callback:AsyncCallback&lt;void&gt;): void ...@@ -1700,13 +1703,13 @@ fdatasync(fd: number, callback:AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------- | ---- | ----------------- | | -------- | ------------------------------- | ---- | ----------------- |
| fd | number | 是 | 待同步文件的文件描述符。 | | fd | number | 是 | 待同步文件的文件描述符。 |
| callback | AsyncCallback&nbsp;&lt;void&gt; | 是 | 异步将文件内容数据同步之后的回调。 | | callback | AsyncCallback&nbsp;&lt;void&gt; | 是 | 异步将文件内容数据同步之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.fdatasync (fd, function (err) { fileio.fdatasync (fd, function (err) {
// do something // do something
...@@ -1722,12 +1725,12 @@ fdatasyncSync(fd: number): void ...@@ -1722,12 +1725,12 @@ fdatasyncSync(fd: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待同步文件的文件描述符。 | | fd | number | 是 | 待同步文件的文件描述符。 |
- 示例： **示例：**
```js ```js
let stat = fileio.fdatasyncSync(fd); let stat = fileio.fdatasyncSync(fd);
``` ```
...@@ -1741,18 +1744,18 @@ symlink(target: string, srcPath: string): Promise&lt;void&gt; ...@@ -1741,18 +1744,18 @@ symlink(target: string, srcPath: string): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ------------ | | ------- | ------ | ---- | ------------ |
| target | string | 是 | 目标文件的绝对路径。 | | target | string | 是 | 目标文件的绝对路径。 |
| srcPath | string | 是 | 符号链接文件的绝对路径。 | | srcPath | string | 是 | 符号链接文件的绝对路径。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例,用于异步获取结果,本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例,用于异步获取结果,本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.symlink(target, srcPath).then(function() { fileio.symlink(target, srcPath).then(function() {
console.info("symlink successfully"); console.info("symlink successfully");
...@@ -1770,14 +1773,14 @@ symlink(target: string, srcPath: string, callback: AsyncCallback&lt;void&gt;): v ...@@ -1770,14 +1773,14 @@ symlink(target: string, srcPath: string, callback: AsyncCallback&lt;void&gt;): v
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ---------------- | | -------- | ------------------------- | ---- | ---------------- |
| target | string | 是 | 目标文件的绝对路径。 | | target | string | 是 | 目标文件的绝对路径。 |
| srcPath | string | 是 | 符号链接文件的绝对路径。 | | srcPath | string | 是 | 符号链接文件的绝对路径。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步创建符号链接信息之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步创建符号链接信息之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.symlink(target, srcPath, function (err) { fileio.symlink(target, srcPath, function (err) {
// do something // do something
...@@ -1793,13 +1796,13 @@ symlinkSync(target: string, srcPath: string): void ...@@ -1793,13 +1796,13 @@ symlinkSync(target: string, srcPath: string): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ------------ | | ------- | ------ | ---- | ------------ |
| target | string | 是 | 目标文件的绝对路径。 | | target | string | 是 | 目标文件的绝对路径。 |
| srcPath | string | 是 | 符号链接文件的绝对路径。 | | srcPath | string | 是 | 符号链接文件的绝对路径。 |
- 示例： **示例：**
```js ```js
fileio.symlinkSync(target, srcPath); fileio.symlinkSync(target, srcPath);
``` ```
...@@ -1813,19 +1816,19 @@ chown(path: string, uid: number, gid: number): Promise&lt;void&gt; ...@@ -1813,19 +1816,19 @@ chown(path: string, uid: number, gid: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | --------------- | | ---- | ------ | ---- | --------------- |
| path | string | 是 | 待改变文件的绝对路径。 | | path | string | 是 | 待改变文件的绝对路径。 |
| uid | number | 是 | 新的UID（UserID）。 | | uid | number | 是 | 新的UID（UserID）。 |
| gid | number | 是 | 新的GID（GroupID）。 | | gid | number | 是 | 新的GID（GroupID）。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例,用于异步获取结果,本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例,用于异步获取结果,本调用将返回空值。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(path); let stat = fileio.statSync(path);
fileio.chown(path, stat.uid, stat.gid).then(function(){ fileio.chown(path, stat.uid, stat.gid).then(function(){
...@@ -1844,7 +1847,7 @@ chown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&gt ...@@ -1844,7 +1847,7 @@ chown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&gt
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | --------------- | | -------- | ------------------------- | ---- | --------------- |
| path | string | 是 | 待改变文件的绝对路径。 | | path | string | 是 | 待改变文件的绝对路径。 |
...@@ -1852,7 +1855,7 @@ chown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&gt ...@@ -1852,7 +1855,7 @@ chown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&gt
| gid | number | 是 | 新的GID。 | | gid | number | 是 | 新的GID。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步改变文件所有者之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步改变文件所有者之后的回调。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(fpath) let stat = fileio.statSync(fpath)
fileio.chown(path, stat.uid, stat.gid, function (err){ fileio.chown(path, stat.uid, stat.gid, function (err){
...@@ -1869,14 +1872,14 @@ chownSync(path: string, uid: number, gid: number): void ...@@ -1869,14 +1872,14 @@ chownSync(path: string, uid: number, gid: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待改变文件的绝对路径。 | | path | string | 是 | 待改变文件的绝对路径。 |
| uid | number | 是 | 新的UID。 | | uid | number | 是 | 新的UID。 |
| gid | number | 是 | 新的GID。 | | gid | number | 是 | 新的GID。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(fpath) let stat = fileio.statSync(fpath)
fileio.chownSync(path, stat.uid, stat.gid); fileio.chownSync(path, stat.uid, stat.gid);
...@@ -1891,17 +1894,17 @@ mkdtemp(prefix: string): Promise&lt;string&gt; ...@@ -1891,17 +1894,17 @@ mkdtemp(prefix: string): Promise&lt;string&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | --------------------------- | | ------ | ------ | ---- | --------------------------- |
| prefix | string | 是 | 用随机产生的字符串替换以“XXXXXX”结尾目录路径。 | | prefix | string | 是 | 用随机产生的字符串替换以“XXXXXX”结尾目录路径。 |
- 返回值： **返回值：**
| 参数名 | 说明 | | 参数名 | 说明 |
| --------------------- | ---------- | | --------------------- | ---------- |
| Promise&lt;string&gt; | 生成的唯一目录路径。 | | Promise&lt;string&gt; | 生成的唯一目录路径。 |
- 示例： **示例：**
```js ```js
fileio.mkdtemp(path + "XXXX").then(function(path){ fileio.mkdtemp(path + "XXXX").then(function(path){
console.info("mkdtemp successfully:"+ path); console.info("mkdtemp successfully:"+ path);
...@@ -1919,13 +1922,13 @@ mkdtemp(prefix: string, callback: AsyncCallback&lt;string&gt;): void ...@@ -1919,13 +1922,13 @@ mkdtemp(prefix: string, callback: AsyncCallback&lt;string&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | --------------------------- | | -------- | --------------------------- | ---- | --------------------------- |
| prefix | string | 是 | 用随机产生的字符串替换以“XXXXXX”结尾目录路径。 | | prefix | string | 是 | 用随机产生的字符串替换以“XXXXXX”结尾目录路径。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 异步创建临时目录之后的回调。 | | callback | AsyncCallback&lt;string&gt; | 是 | 异步创建临时目录之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.mkdtemp(path + "XXXX", function (err, res) { fileio.mkdtemp(path + "XXXX", function (err, res) {
// do something // do something
...@@ -1941,17 +1944,17 @@ mkdtempSync(prefix: string): string ...@@ -1941,17 +1944,17 @@ mkdtempSync(prefix: string): string
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | --------------------------- | | ------ | ------ | ---- | --------------------------- |
| prefix | string | 是 | 用随机产生的字符串替换以“XXXXXX”结尾目录路径。 | | prefix | string | 是 | 用随机产生的字符串替换以“XXXXXX”结尾目录路径。 |
- 返回值： **返回值：**
| 参数名 | 说明 | | 参数名 | 说明 |
| ------ | ---------- | | ------ | ---------- |
| string | 产生的唯一目录路径。 | | string | 产生的唯一目录路径。 |
- 示例： **示例：**
```js ```js
let res = fileio.mkdtempSync(path + "XXXX"); let res = fileio.mkdtempSync(path + "XXXX");
``` ```
...@@ -1965,18 +1968,18 @@ fchmod(fd: number, mode: number): Promise&lt;void&gt; ...@@ -1965,18 +1968,18 @@ fchmod(fd: number, mode: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| fd | number | 是 | 待改变文件的文件描述符。 | | fd | number | 是 | 待改变文件的文件描述符。 |
| mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
- 返回值： **返回值：**
| 参数名 | 说明 | | 参数名 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例,用于异步获取结果,本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例,用于异步获取结果,本调用将返回空值。 |
- 示例： **示例：**
```js ```js
fileio.fchmod(fd, mode).then(function() { fileio.fchmod(fd, mode).then(function() {
console.info("chmod successfully"); console.info("chmod successfully");
...@@ -1994,14 +1997,14 @@ fchmod(fd: number, mode: number, callback: AsyncCallback&lt;void&gt;): void ...@@ -1994,14 +1997,14 @@ fchmod(fd: number, mode: number, callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------- | ---- | ---------------------------------------- | | -------- | ------------------------------- | ---- | ---------------------------------------- |
| fd | number | 是 | 待改变文件的文件描述符。 | | fd | number | 是 | 待改变文件的文件描述符。 |
| mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
| callback | AsyncCallback&nbsp;&lt;void&gt; | 是 | 异步改变文件权限之后的回调。 | | callback | AsyncCallback&nbsp;&lt;void&gt; | 是 | 异步改变文件权限之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.fchmod(fd, mode, function (err) { fileio.fchmod(fd, mode, function (err) {
// do something // do something
...@@ -2017,13 +2020,13 @@ fchmodSync(fd: number, mode: number): void ...@@ -2017,13 +2020,13 @@ fchmodSync(fd: number, mode: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| fd | number | 是 | 待改变文件的文件描述符。 | | fd | number | 是 | 待改变文件的文件描述符。 |
| mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 | | mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限。<br/>-&nbsp;0o700：所有者具有读、写及可执行权限。<br/>-&nbsp;0o400：所有者具有读权限。<br/>-&nbsp;0o200：所有者具有写权限。<br/>-&nbsp;0o100：所有者具有可执行权限。<br/>-&nbsp;0o070：所有用户组具有读、写及可执行权限。<br/>-&nbsp;0o040：所有用户组具有读权限。<br/>-&nbsp;0o020：所有用户组具有写权限。<br/>-&nbsp;0o010：所有用户组具有可执行权限。<br/>-&nbsp;0o007：其余用户具有读、写及可执行权限。<br/>-&nbsp;0o004：其余用户具有读权限。<br/>-&nbsp;0o002：其余用户具有写权限。<br/>-&nbsp;0o001：其余用户具有可执行权限。 |
- 示例： **示例：**
```js ```js
fileio.fchmodSync(fd, mode); fileio.fchmodSync(fd, mode);
``` ```
...@@ -2037,18 +2040,18 @@ createStream(path: string, mode: string): Promise&lt;Stream&gt; ...@@ -2037,18 +2040,18 @@ createStream(path: string, mode: string): Promise&lt;Stream&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
| mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | | mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------------------- | --------- | | --------------------------------- | --------- |
| Promise&lt;[Stream](#stream7)&gt; | 返回文件流的结果。 | | Promise&lt;[Stream](#stream7)&gt; | 返回文件流的结果。 |
- 示例： **示例：**
```js ```js
fileio.createStream(path, "r+").then(function(stream){ fileio.createStream(path, "r+").then(function(stream){
console.info("createStream successfully"); console.info("createStream successfully");
...@@ -2066,14 +2069,14 @@ createStream(path: string, mode: string, callback: AsyncCallback&lt;Stream&gt;): ...@@ -2066,14 +2069,14 @@ createStream(path: string, mode: string, callback: AsyncCallback&lt;Stream&gt;):
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------- | ---- | ---------------------------------------- | | -------- | --------------------------------------- | ---- | ---------------------------------------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
| mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | | mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 |
| callback | AsyncCallback&lt;[Stream](#stream7)&gt; | 是 | 异步打开文件流之后的回调。 | | callback | AsyncCallback&lt;[Stream](#stream7)&gt; | 是 | 异步打开文件流之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.createStream(path, mode, function(err, stream){ fileio.createStream(path, mode, function(err, stream){
// do something // do something
...@@ -2089,18 +2092,18 @@ createStreamSync(path: string, mode: string): Stream ...@@ -2089,18 +2092,18 @@ createStreamSync(path: string, mode: string): Stream
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
| mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | | mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 |
- 返回值： **返回值：**
| 参数名 | 说明 | | 参数名 | 说明 |
| ------------------ | --------- | | ------------------ | --------- |
| [Stream](#stream7) | 返回文件流的结果。 | | [Stream](#stream7) | 返回文件流的结果。 |
- 示例： **示例：**
```js ```js
let ss = fileio.createStreamSync(path, "r+"); let ss = fileio.createStreamSync(path, "r+");
``` ```
...@@ -2114,18 +2117,18 @@ fdopenStream(fd: number, mode: string): Promise&lt;Stream&gt; ...@@ -2114,18 +2117,18 @@ fdopenStream(fd: number, mode: string): Promise&lt;Stream&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| fd | number | 是 | 待打开文件的文件描述符。 | | fd | number | 是 | 待打开文件的文件描述符。 |
| mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | | mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 |
- 返回值： **返回值：**
| 参数名 | 说明 | | 参数名 | 说明 |
| --------------------------------- | --------- | | --------------------------------- | --------- |
| Promise&lt;[Stream](#stream7)&gt; | 返回文件流的结果。 | | Promise&lt;[Stream](#stream7)&gt; | 返回文件流的结果。 |
- 示例： **示例：**
```js ```js
fileio.fdopenStream(fd, mode).then(function(stream){ fileio.fdopenStream(fd, mode).then(function(stream){
console.info("openStream successfully"); console.info("openStream successfully");
...@@ -2143,14 +2146,14 @@ fdopenStream(fd: number, mode: string, callback: AsyncCallback&lt;Stream&gt;): v ...@@ -2143,14 +2146,14 @@ fdopenStream(fd: number, mode: string, callback: AsyncCallback&lt;Stream&gt;): v
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- | | -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| fd | number | 是 | 待打开文件的文件描述符。 | | fd | number | 是 | 待打开文件的文件描述符。 |
| mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | | mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 |
| callback | AsyncCallback&nbsp;&lt;[Stream](#stream7)&gt; | 是 | 异步打开文件流之后的回调。 | | callback | AsyncCallback&nbsp;&lt;[Stream](#stream7)&gt; | 是 | 异步打开文件流之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.fdopenStream(fd, mode, function (err, stream) { fileio.fdopenStream(fd, mode, function (err, stream) {
// do something // do something
...@@ -2166,18 +2169,18 @@ fdopenStreamSync(fd: number, mode: string): Stream ...@@ -2166,18 +2169,18 @@ fdopenStreamSync(fd: number, mode: string): Stream
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------------------- | | ---- | ------ | ---- | ---------------------------------------- |
| fd | number | 是 | 待打开文件的文件描述符。 | | fd | number | 是 | 待打开文件的文件描述符。 |
| mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | | mode | string | 是 | -&nbsp;r：打开只读文件，该文件必须存在。<br/>-&nbsp;r+：打开可读写的文件，该文件必须存在。<br/>-&nbsp;w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。<br/>-&nbsp;a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。<br/>-&nbsp;a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 |
- 返回值： **返回值：**
| 参数名 | 说明 | | 参数名 | 说明 |
| ------------------ | --------- | | ------------------ | --------- |
| [Stream](#stream7) | 返回文件流的结果。 | | [Stream](#stream7) | 返回文件流的结果。 |
- 示例： **示例：**
```js ```js
let ss = fileio.fdopenStreamSync(fd, "r+"); let ss = fileio.fdopenStreamSync(fd, "r+");
``` ```
...@@ -2191,19 +2194,19 @@ fchown(fd: number, uid: number, gid: number): Promise&lt;void&gt; ...@@ -2191,19 +2194,19 @@ fchown(fd: number, uid: number, gid: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待改变文件的文件描述符。 | | fd | number | 是 | 待改变文件的文件描述符。 |
| uid | number | 是 | 文件所有者的UID。 | | uid | number | 是 | 文件所有者的UID。 |
| gid | number | 是 | 文件所有组的GID。 | | gid | number | 是 | 文件所有组的GID。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
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() {
...@@ -2222,7 +2225,7 @@ fchown(fd: number, uid: number, gid: number, callback: AsyncCallback&lt;void&gt; ...@@ -2222,7 +2225,7 @@ fchown(fd: number, uid: number, gid: number, callback: AsyncCallback&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | --------------- | | -------- | ------------------------- | ---- | --------------- |
| fd | number | 是 | 待改变文件的文件描述符。 | | fd | number | 是 | 待改变文件的文件描述符。 |
...@@ -2230,7 +2233,7 @@ fchown(fd: number, uid: number, gid: number, callback: AsyncCallback&lt;void&gt; ...@@ -2230,7 +2233,7 @@ fchown(fd: number, uid: number, gid: number, callback: AsyncCallback&lt;void&gt;
| gid | number | 是 | 文件所有组的GID。 | | gid | number | 是 | 文件所有组的GID。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步改变文件所有者之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步改变文件所有者之后的回调。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(fpath); let stat = fileio.statSync(fpath);
fileio.fchown(fd, stat.uid, stat.gid, function (err){ fileio.fchown(fd, stat.uid, stat.gid, function (err){
...@@ -2247,14 +2250,14 @@ fchownSync(fd: number, uid: number, gid: number): void ...@@ -2247,14 +2250,14 @@ fchownSync(fd: number, uid: number, gid: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------ | | ---- | ------ | ---- | ------------ |
| fd | number | 是 | 待改变文件的文件描述符。 | | fd | number | 是 | 待改变文件的文件描述符。 |
| uid | number | 是 | 文件所有者的UID。 | | uid | number | 是 | 文件所有者的UID。 |
| gid | number | 是 | 文件所有组的GID。 | | gid | number | 是 | 文件所有组的GID。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(fpath); let stat = fileio.statSync(fpath);
fileio.fchownSync(fd, stat.uid, stat.gid); fileio.fchownSync(fd, stat.uid, stat.gid);
...@@ -2269,19 +2272,19 @@ lchown(path: string, uid: number, gid: number): Promise&lt;void&gt; ...@@ -2269,19 +2272,19 @@ lchown(path: string, uid: number, gid: number): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
| uid | number | 是 | 新的UID。 | | uid | number | 是 | 新的UID。 |
| gid | number | 是 | 新的GID。 | | gid | number | 是 | 新的GID。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ---------------------------- | | ------------------- | ---------------------------- |
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。本调用将返回空值。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(path); let stat = fileio.statSync(path);
fileio.lchown(path, stat.uid, stat.gid).then(function() { fileio.lchown(path, stat.uid, stat.gid).then(function() {
...@@ -2300,7 +2303,7 @@ lchown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&g ...@@ -2300,7 +2303,7 @@ lchown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&g
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | --------------- | | -------- | ------------------------- | ---- | --------------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
...@@ -2308,7 +2311,7 @@ lchown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&g ...@@ -2308,7 +2311,7 @@ lchown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&g
| gid | number | 是 | 新的GID。 | | gid | number | 是 | 新的GID。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步改变文件所有者之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步改变文件所有者之后的回调。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(path); let stat = fileio.statSync(path);
fileio.lchown(path, stat.uid, stat.gid, function (err){ fileio.lchown(path, stat.uid, stat.gid, function (err){
...@@ -2325,14 +2328,14 @@ lchownSync(path: string, uid: number, gid: number): void ...@@ -2325,14 +2328,14 @@ lchownSync(path: string, uid: number, gid: number): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ----------- | | ---- | ------ | ---- | ----------- |
| path | string | 是 | 待打开文件的绝对路径。 | | path | string | 是 | 待打开文件的绝对路径。 |
| uid | number | 是 | 新的UID。 | | uid | number | 是 | 新的UID。 |
| gid | number | 是 | 新的GID。 | | gid | number | 是 | 新的GID。 |
- 示例： **示例：**
```js ```js
let stat = fileio.statSync(path); let stat = fileio.statSync(path);
fileio.lchownSync(path, stat.uid, stat.gid); fileio.lchownSync(path, stat.uid, stat.gid);
...@@ -2347,19 +2350,19 @@ createWatcher(filename: string, events: number, callback: AsyncCallback&lt;numbe ...@@ -2347,19 +2350,19 @@ createWatcher(filename: string, events: number, callback: AsyncCallback&lt;numbe
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------- | ---- | ---------------------------------------- | | -------- | --------------------------------- | ---- | ---------------------------------------- |
| filename | string | 是 | 待监视文件的绝对路径。 | | filename | string | 是 | 待监视文件的绝对路径。 |
| events | Number | 是 | -&nbsp;1:&nbsp;监听文件或者目录是否发生重命名。<br/>-&nbsp;2：监听文件或者目录内容的是否修改。<br/>-&nbsp;3：两者都有。 | | events | Number | 是 | -&nbsp;1:&nbsp;监听文件或者目录是否发生重命名。<br/>-&nbsp;2：监听文件或者目录内容的是否修改。<br/>-&nbsp;3：两者都有。 |
| callback | AsyncCallback&lt;number&nbsp;&gt; | 是 | 每发生变化一次，调用一次此函数。 | | callback | AsyncCallback&lt;number&nbsp;&gt; | 是 | 每发生变化一次，调用一次此函数。 |
- 返回值： **返回值：**
| 参数名 | 说明 | | 参数名 | 说明 |
| -------------------- | ---------- | | -------------------- | ---------- |
| [Watcher](#watcher7) | 文件变化监听的实例。 | | [Watcher](#watcher7) | 文件变化监听的实例。 |
- 示例： **示例：**
```js ```js
fileio.createWatcher(filename, events, function(watcher){ fileio.createWatcher(filename, events, function(watcher){
// do something // do something
...@@ -2412,12 +2415,12 @@ isBlockDevice(): boolean ...@@ -2412,12 +2415,12 @@ isBlockDevice(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | ---------------- | | ------- | ---------------- |
| boolean | 表示文件是否是块特殊设备。 | | boolean | 表示文件是否是块特殊设备。 |
- 示例： **示例：**
```js ```js
let isBLockDevice = fileio.statSync(path).isBlockDevice(); let isBLockDevice = fileio.statSync(path).isBlockDevice();
``` ```
...@@ -2431,12 +2434,12 @@ isCharacterDevice(): boolean ...@@ -2431,12 +2434,12 @@ isCharacterDevice(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | ----------------- | | ------- | ----------------- |
| boolean | 表示文件是否是字符特殊设备。 | | boolean | 表示文件是否是字符特殊设备。 |
- 示例： **示例：**
```js ```js
let isCharacterDevice = fileio.statSync(path).isCharacterDevice(); let isCharacterDevice = fileio.statSync(path).isCharacterDevice();
``` ```
...@@ -2450,12 +2453,12 @@ isDirectory(): boolean ...@@ -2450,12 +2453,12 @@ isDirectory(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | ------------- | | ------- | ------------- |
| boolean | 表示文件是否是目录。 | | boolean | 表示文件是否是目录。 |
- 示例： **示例：**
```js ```js
let isDirectory = fileio.statSync(path).isDirectory(); let isDirectory = fileio.statSync(path).isDirectory();
``` ```
...@@ -2469,12 +2472,12 @@ isFIFO(): boolean ...@@ -2469,12 +2472,12 @@ isFIFO(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | --------------------- | | ------- | --------------------- |
| boolean | 表示文件是否是&nbsp;FIFO。 | | boolean | 表示文件是否是&nbsp;FIFO。 |
- 示例： **示例：**
```js ```js
let isFIFO = fileio.statSync(path).isFIFO(); let isFIFO = fileio.statSync(path).isFIFO();
``` ```
...@@ -2488,12 +2491,12 @@ isFile(): boolean ...@@ -2488,12 +2491,12 @@ isFile(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | --------------- | | ------- | --------------- |
| boolean | 表示文件是否是普通文件。 | | boolean | 表示文件是否是普通文件。 |
- 示例： **示例：**
```js ```js
let isFile = fileio.statSync(fpath).isFile(); let isFile = fileio.statSync(fpath).isFile();
``` ```
...@@ -2507,12 +2510,12 @@ isSocket(): boolean ...@@ -2507,12 +2510,12 @@ isSocket(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | -------------- | | ------- | -------------- |
| boolean | 表示文件是否是套接字。 | | boolean | 表示文件是否是套接字。 |
- 示例： **示例：**
```js ```js
let isSocket = fileio.statSync(path).isSocket(); let isSocket = fileio.statSync(path).isSocket();
``` ```
...@@ -2526,12 +2529,12 @@ isSymbolicLink(): boolean ...@@ -2526,12 +2529,12 @@ isSymbolicLink(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | --------------- | | ------- | --------------- |
| boolean | 表示文件是否是符号链接。 | | boolean | 表示文件是否是符号链接。 |
- 示例： **示例：**
```js ```js
let isSymbolicLink = fileio.statSync(path).isSymbolicLink(); let isSymbolicLink = fileio.statSync(path).isSymbolicLink();
``` ```
...@@ -2550,7 +2553,7 @@ stop(): Promise&lt;void&gt; ...@@ -2550,7 +2553,7 @@ stop(): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 示例： **示例：**
```js ```js
fileio.stop(); fileio.stop();
``` ```
...@@ -2564,12 +2567,12 @@ stop(callback: AsyncCallback&lt;void&gt;): void ...@@ -2564,12 +2567,12 @@ stop(callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ---------------------- | | -------- | ------------------------- | ---- | ---------------------- |
| callback | AsyncCallback&lt;void&gt; | 是 | 以异步方法关闭watcher监听之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 以异步方法关闭watcher监听之后的回调。 |
- 示例： **示例：**
```js ```js
fileio.stop(function(err){ fileio.stop(function(err){
// do something // do something
...@@ -2590,12 +2593,12 @@ close(): Promise&lt;void&gt; ...@@ -2590,12 +2593,12 @@ close(): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ------------- | | ------------------- | ------------- |
| Promise&lt;void&gt; | 表示异步关闭文件流的结果。 | | Promise&lt;void&gt; | 表示异步关闭文件流的结果。 |
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path);
ss.close().then(function(){ ss.close().then(function(){
...@@ -2614,12 +2617,12 @@ close(callback: AsyncCallback&lt;void&gt;): void ...@@ -2614,12 +2617,12 @@ close(callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------- | | -------- | ------------------------- | ---- | ------------- |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步关闭文件流之后的回调。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步关闭文件流之后的回调。 |
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path);
ss.close(function (err) { ss.close(function (err) {
...@@ -2636,7 +2639,7 @@ closeSync(): void ...@@ -2636,7 +2639,7 @@ closeSync(): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path);
ss.closeSync(); ss.closeSync();
...@@ -2651,12 +2654,12 @@ flush(): Promise&lt;void&gt; ...@@ -2651,12 +2654,12 @@ flush(): Promise&lt;void&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | ------------- | | ------------------- | ------------- |
| Promise&lt;void&gt; | 表示异步刷新文件流的结果。 | | Promise&lt;void&gt; | 表示异步刷新文件流的结果。 |
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path);
ss.flush().then(function (){ ss.flush().then(function (){
...@@ -2675,12 +2678,12 @@ flush(callback: AsyncCallback&lt;void&gt;): void ...@@ -2675,12 +2678,12 @@ flush(callback: AsyncCallback&lt;void&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | -------------- | | -------- | ------------------------- | ---- | -------------- |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步刷新文件流后的回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 异步刷新文件流后的回调函数。 |
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path);
ss.flush(function (err) { ss.flush(function (err) {
...@@ -2697,7 +2700,7 @@ flushSync(): void ...@@ -2697,7 +2700,7 @@ flushSync(): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path);
ss.flushSync(); ss.flushSync();
...@@ -2717,18 +2720,18 @@ write(buffer: ArrayBuffer | string, options?: { ...@@ -2717,18 +2720,18 @@ write(buffer: ArrayBuffer | string, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------- | ---- | ---------------------------------------- | | ------- | ------------------------------- | ---- | ---------------------------------------- |
| buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 | | buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>约束：offset+length<=buffer.size。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | -------- | | --------------------- | -------- |
| Promise&lt;number&gt; | 实际写入的长度。 | | Promise&lt;number&gt; | 实际写入的长度。 |
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(fpath, "r+"); let ss= fileio.createStreamSync(fpath, "r+");
ss.write("hello, world",{offset: 1,length: 5,position: 5,encoding :'utf-8'}).then(function (number){ ss.write("hello, world",{offset: 1,length: 5,position: 5,encoding :'utf-8'}).then(function (number){
...@@ -2752,14 +2755,14 @@ write(buffer: ArrayBuffer | string, options: { ...@@ -2752,14 +2755,14 @@ write(buffer: ArrayBuffer | string, options: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------- | ---- | ------------------------------------------------------------ | | -------- | ------------------------------- | ---- | ------------------------------------------------------------ |
| buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 | | buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>约束：offset+length<=buffer.size。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 异步写入完成后执行的回调函数。 | | callback | AsyncCallback&lt;number&gt; | 是 | 异步写入完成后执行的回调函数。 |
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(fpath, "r+"); let ss= fileio.createStreamSync(fpath, "r+");
ss.write("hello, world", {offset: 1, length: 5, position: 5, encoding :'utf-8'}, function (err, bytesWritten) { ss.write("hello, world", {offset: 1, length: 5, position: 5, encoding :'utf-8'}, function (err, bytesWritten) {
...@@ -2784,18 +2787,18 @@ writeSync(buffer: ArrayBuffer | string, options?: { ...@@ -2784,18 +2787,18 @@ writeSync(buffer: ArrayBuffer | string, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------- | ---- | ---------------------------------------- | | ------- | ------------------------------- | ---- | ---------------------------------------- |
| buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 | | buffer | ArrayBuffer&nbsp;\|&nbsp;string | 是 | 待写入文件的数据，可来自缓冲区或字符串。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。<br/>-&nbsp;encoding，string类型，当数据是string类型时有效，表示数据的编码方式，默认&nbsp;'utf-8'。仅支持&nbsp;'utf-8'。<br/>约束：offset+length<=buffer.size。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------ | -------- | | ------ | -------- |
| number | 实际写入的长度。 | | number | 实际写入的长度。 |
- 示例： **示例：**
```js ```js
let ss= fileio.createStreamSync(fpath,"r+"); let ss= fileio.createStreamSync(fpath,"r+");
let num = ss.writeSync("hello, world", {offset: 1, length: 5, position: 5, encoding :'utf-8'}); let num = ss.writeSync("hello, world", {offset: 1, length: 5, position: 5, encoding :'utf-8'});
...@@ -2814,18 +2817,18 @@ read(buffer: ArrayBuffer, options?: { ...@@ -2814,18 +2817,18 @@ read(buffer: ArrayBuffer, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------- | ---- | ---------------------------------------- | | ------- | ----------- | ---- | ---------------------------------------- |
| buffer | ArrayBuffer | 是 | 用于读取文件的缓冲区。 | | buffer | ArrayBuffer | 是 | 用于读取文件的缓冲区。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>约束：offset+length<=buffer.size。 |
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------- | ------ | | ---------------------------------- | ------ |
| Promise&lt;[ReadOut](#readout)&gt; | 读取的结果。 | | Promise&lt;[ReadOut](#readout)&gt; | 读取的结果。 |
- 示例： **示例：**
```js ```js
let ss = fileio.createStreamSync(fpath, "r+"); let ss = fileio.createStreamSync(fpath, "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){
...@@ -2849,14 +2852,14 @@ read(buffer: ArrayBuffer, options: { ...@@ -2849,14 +2852,14 @@ read(buffer: ArrayBuffer, options: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- | | -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| buffer | ArrayBuffer | 是 | 用于读取文件的缓冲区。 | | buffer | ArrayBuffer | 是 | 用于读取文件的缓冲区。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>约束：offset+length<=buffer.size。 |
| callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是 | 异步从流文件读取数据之后的回调。 | | callback | AsyncCallback&lt;[ReadOut](#readout)&gt; | 是 | 异步从流文件读取数据之后的回调。 |
- 示例： **示例：**
```js ```js
let ss = fileio.createStreamSync(fpath, "r+"); let ss = fileio.createStreamSync(fpath, "r+");
ss.read(new ArrayBuffer(4096),{offset: 1, length: 5, position: 5},function (err, readOut) { ss.read(new ArrayBuffer(4096),{offset: 1, length: 5, position: 5},function (err, readOut) {
...@@ -2880,18 +2883,20 @@ readSync(buffer: ArrayBuffer, options?: { ...@@ -2880,18 +2883,20 @@ readSync(buffer: ArrayBuffer, options?: {
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------- | ---- | ---------------------------------------- | | ------- | ----------- | ---- | ---------------------------------------- |
| buffer | ArrayBuffer | 是 | 用于读取文件的缓冲区。 | | buffer | ArrayBuffer | 是 | 用于读取文件的缓冲区。 |
| options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>-&nbsp;约束:offset+length<=buffer.size。 | | options | Object | 否 | 支持如下选项：<br/>-&nbsp;offset，number类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。<br/>-&nbsp;length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。<br/>-&nbsp;position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读。<br/>约束：offset+length<=buffer.size。 |
**返回值：**
- 返回值：
| 类型 | 说明 | | 类型 | 说明 |
| ------ | -------- | | ------ | -------- |
| number | 实际读取的长度。 | | number | 实际读取的长度。 |
- 示例： **示例：**
```js ```js
let ss = fileio.createStreamSync(fpath, "r+"); let ss = fileio.createStreamSync(fpath, "r+");
let num = ss.readSync(new ArrayBuffer(4096), {offset: 1, length: 5, position: 5}); let num = ss.readSync(new ArrayBuffer(4096), {offset: 1, length: 5, position: 5});
...@@ -2911,12 +2916,12 @@ read(): Promise&lt;Dirent&gt; ...@@ -2911,12 +2916,12 @@ read(): Promise&lt;Dirent&gt;
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| -------------------------------- | ------------- | | -------------------------------- | ------------- |
| Promise&lt;[Dirent](#dirent)&gt; | 表示异步读取目录项的结果。 | | Promise&lt;[Dirent](#dirent)&gt; | 表示异步读取目录项的结果。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
dir.read().then(function (dirent){ dir.read().then(function (dirent){
...@@ -2935,12 +2940,12 @@ read(callback: AsyncCallback&lt;Dirent&gt;): void ...@@ -2935,12 +2940,12 @@ read(callback: AsyncCallback&lt;Dirent&gt;): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 参数： **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ---------------- | | -------- | -------------------------------------- | ---- | ---------------- |
| callback | AsyncCallback&lt;[Dirent](#dirent)&gt; | 是 | 异步读取下一个目录项之后的回调。 | | callback | AsyncCallback&lt;[Dirent](#dirent)&gt; | 是 | 异步读取下一个目录项之后的回调。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
dir.read(function (err, dirent) { dir.read(function (err, dirent) {
...@@ -2960,12 +2965,12 @@ readSync(): Dirent ...@@ -2960,12 +2965,12 @@ readSync(): Dirent
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ----------------- | -------- | | ----------------- | -------- |
| [Dirent](#dirent) | 表示一个目录项。 | | [Dirent](#dirent) | 表示一个目录项。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
let dirent = dir.readSync(); let dirent = dir.readSync();
...@@ -2980,7 +2985,7 @@ closeSync(): void ...@@ -2980,7 +2985,7 @@ closeSync(): void
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
dir.closeSync(); dir.closeSync();
...@@ -3008,12 +3013,12 @@ isBlockDevice(): boolean ...@@ -3008,12 +3013,12 @@ isBlockDevice(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | ---------------- | | ------- | ---------------- |
| boolean | 表示当前目录项是否是块特殊设备。 | | boolean | 表示当前目录项是否是块特殊设备。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
let isBLockDevice = dir.readSync().isBlockDevice(); let isBLockDevice = dir.readSync().isBlockDevice();
...@@ -3028,12 +3033,12 @@ isCharacterDevice(): boolean ...@@ -3028,12 +3033,12 @@ isCharacterDevice(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | ----------------- | | ------- | ----------------- |
| boolean | 表示当前目录项是否是字符特殊设备。 | | boolean | 表示当前目录项是否是字符特殊设备。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
let isCharacterDevice = dir.readSync().isCharacterDevice(); let isCharacterDevice = dir.readSync().isCharacterDevice();
...@@ -3048,12 +3053,12 @@ isDirectory(): boolean ...@@ -3048,12 +3053,12 @@ isDirectory(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | ------------- | | ------- | ------------- |
| boolean | 表示当前目录项是否是目录。 | | boolean | 表示当前目录项是否是目录。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
let isDirectory = dir.readSync().isDirectory(); let isDirectory = dir.readSync().isDirectory();
...@@ -3068,12 +3073,12 @@ isFIFO(): boolean ...@@ -3068,12 +3073,12 @@ isFIFO(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | --------------- | | ------- | --------------- |
| boolean | 表示当前目录项是否是FIFO。 | | boolean | 表示当前目录项是否是FIFO。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
let isFIFO = dir.readSync().isFIFO(); let isFIFO = dir.readSync().isFIFO();
...@@ -3088,12 +3093,12 @@ isFile(): boolean ...@@ -3088,12 +3093,12 @@ isFile(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | --------------- | | ------- | --------------- |
| boolean | 表示当前目录项是否是普通文件。 | | boolean | 表示当前目录项是否是普通文件。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
let isFile = dir.readSync().isFile(); let isFile = dir.readSync().isFile();
...@@ -3108,12 +3113,12 @@ isSocket(): boolean ...@@ -3108,12 +3113,12 @@ isSocket(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | -------------- | | ------- | -------------- |
| boolean | 表示当前目录项是否是套接字。 | | boolean | 表示当前目录项是否是套接字。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(dpath); let dir = fileio.opendirSync(dpath);
let isSocket = dir.readSync().isSocket(); let isSocket = dir.readSync().isSocket();
...@@ -3128,12 +3133,12 @@ isSymbolicLink(): boolean ...@@ -3128,12 +3133,12 @@ isSymbolicLink(): boolean
**系统能力**：SystemCapability.FileManagement.File.FileIO **系统能力**：SystemCapability.FileManagement.File.FileIO
- 返回值： **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------- | --------------- | | ------- | --------------- |
| boolean | 表示当前目录项是否是符号链接。 | | boolean | 表示当前目录项是否是符号链接。 |
- 示例： **示例：**
```js ```js
let dir = fileio.opendirSync(path); let dir = fileio.opendirSync(path);
let isSymbolicLink = dir.readSync().isSymbolicLink(); let isSymbolicLink = dir.readSync().isSymbolicLink();
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或