# WriteResult FileSystemManager.writeSync(Object object)

基础库 2.16.1 开始支持,低版本需做兼容处理

同步写入文件

# 参数

# Object object

属性 类型 默认值 必填 说明
fd string 文件描述符。fd 通过 FileSystemManager.openFileSystemManager.openSync 接口获得
data string/ArrayBuffer 写入的内容,类型为 String 或 ArrayBuffer
offset number 0 只在 data 类型是 ArrayBuffer 时有效,决定 arrayBuffe 中要被写入的部位,即 arrayBuffer 中的索引,默认0
length number 只在 data 类型是 ArrayBuffer 时有效,指定要写入的字节数,默认为 arrayBuffer 从0开始偏移 offset 个字节后剩余的字节数
encoding string utf8 只在 data 类型是 String 时有效,指定写入文件的字符编码,默认为 utf8
合法值 说明
ascii
base64
binary
hex
ucs2 以小端序读取
ucs-2 以小端序读取
utf16le 以小端序读取
utf-16le 以小端序读取
utf-8
utf8
latin1
position number 指定文件开头的偏移量,即数据要被写入的位置。当 position 不传或者传入非 Number 类型的值时,数据会被写入当前指针所在位置。

# 返回值

# WriteResult

文件写入结果

# 错误

错误码 错误信息 说明
bad file descriptor 无效的文件描述符
fail permission denied 指定的 fd 路径没有写权限
fail sdcard not mounted android sdcard 挂载失败

# 示例代码

const fs = wx.getFileSystemManager()
const fd = fs.openSync({
  filePath: `${wx.env.USER_DATA_PATH}/hello.txt`,
  flag: 'a+'
})
const res = fs.writeSync({
  fd: fd,
  data: 'some text'
})
console.log(res.bytesWritten)