# FileSystemManager.write(Object object)

Start from base library version 2.16.1. Please remaining backward compatible.

with Promise style call: Not supported

Mini Program plugin: Support, need to Mini Program base library version no less than 2.19.2

Write file

# parameter

# Object object

attribute type Default values Required Introductions
fd string yes File descriptor. fd adopt FileSystemManager.open or FileSystemManager.openSync Interface acquisition
data string/ArrayBuffer yes Write content of type String or ArrayBuffer
offset number 0 no Only in data Type is ArrayBuffer When valid, decided arrayBuffe To be written to in the arrayBuffer Index in, default 0
length number no Only in data Type is ArrayBuffer Specifies the number of bytes to write, and defaults to arrayBuffer Offset from 0 offset Number of bytes remaining after 1 byte
encoding string utf8 no Only in data Type is String Specifies the character encoding to write to the file, and defaults to utf8
position number no Specifies the offset at the beginning of the file, where the data will be written. when position Not passed or passed in Number Type, the data is written to the current pointer location.
success function no Interface calls the successful callback function
fail function no Interface calls failed callback functions
complete function no Callback function at the end of an interface call (both successful and unsuccessful calls are executed)

object.encoding Legal value

value Introductions Minimum version
ascii
base64
binary
hex
ucs2 Read in small endorder
ucs-2 Read in small endorder
Utf16le Read in small endorder
utf-16le Read in small endorder
utf-8
utf8
latin1

# object.success callback

# parameter
# Object res
attribute type Introductions
bytesWritten number Number of bytes actually written to the file (note that the number of byte writes is not necessarily the same as the string characters written)

# object.fail callback

# parameter
# Object res
attribute type Introductions
errMsg string Error message

res.errMsg Legal value

value Introductions Minimum version
bad file descriptor Invalid file descriptor
fail permission denied Specified fd Path does not have write permissions
fail sdcard not mounted android sdcard Mount failure

# sample code

const fs = wx.getFileSystemManager()
// Open the file
fs.open({
  filePath: `${wx.env.USER_DATA_PATH}/hello.txt`, 
  flag: 'a+',
  success(res) {
    // Write file
    fs.write({
      fd: res.fd,
      data: 'some text',
      success(res) {
        console.log(res.bytesWritten)
      }
    })
  }
})