FileSystemManager.write

简介

写入文件。

使用限制

基础库版本从 3.0.0 或更高版本支持。

参数

Object object

属性	类型	默认值	必填	说明
fd	string		是	文件描述符。fd 通过 FileSystemManager.open 接口获得
data	string		是	写入的内容，类型为 String (暂时不支持 ArrayBuffer)
encoding	string	utf8	否	只在 data 类型是 String 时有效，指定写入文件的字符编码，默认为 utf8。 合法值： 1. ascii 2. base64 3. binary 4. hex 5. ucs2 以小端序读取 6. ucs-2 以小端序读取 7. utf16le 以小端序读取 8. utf-16le 以小端序读取 9. utf-8 10. utf8 11. latin1
position	number	0	否	指定文件开头的偏移量，即数据要被写入的位置。当 position 不传或者传入非 Number 类型的值时，数据会被写入当前指针所在位置。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
bytesWritten	number	实际被写入到文件中的字节数（注意，被写入的字节数不一定与被写入的字符串字符数相同）
success	string	true-成功

object.fail 回调函数

参数

Object res

属性	类型	说明
errMsg	string	错误信息
success	string	false-失败

errMsg 说明

错误信息	说明
parameter error: F10001	参数不合法
bad file descriptor: F10003	无效的文件描述符
fail permission denied: F10005	指定的 fd 路径没有读权限
the named is ${encoding} charset is not supported!	当前字符编码不支持

示例代码

// pages/index/index.js

Page({
  write() {
    const fs = dlt.getFileSystemManager();
    // 打开文件
    fs.open({
      filePath: `${dlt.env.USER_DATA_PATH}/hello.txt`,
      flag: "a+",
      success(res) {
        // 写入文件
        fs.write({
          fd: res.fd,
          data: "some text",
          success(res) {
            console.log(res.bytesWritten);
          },
        });
      },
    });
  },
});