# WriteResult FileSystemManager.writeSync(Object object)
基础库 2.16.1 开始支持,低版本需做兼容处理。
小程序插件:支持,需要小程序基础库版本不低于 2.19.2
同步写入文件
# 参数
# Object object
属性 | 类型 | 默认值 | 必填 | 说明 | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fd | string | 是 | 文件描述符。fd 通过 FileSystemManager.open 或 FileSystemManager.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 | |||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
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)