# FileSystemManager.ftruncate(Object object)

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

Promise 风格 调用:不支持

小程序插件:支持,需要小程序基础库版本不低于 2.19.2

# 功能描述

对文件内容进行截断操作

# 参数

# Object object

属性 类型 默认值 必填 说明
fd string 文件描述符。fd 通过 FileSystemManager.openFileSystemManager.openSync 接口获得
length number 截断位置,默认0。如果 length 小于文件长度(单位:字节),则只有前面 length 个字节会保留在文件中,其余内容会被删除;如果 length 大于文件长度,则会对其进行扩展,并且扩展部分将填充空字节('\0')
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# object.fail 回调函数

# 参数
# Object res
属性 类型 说明
errMsg string 错误信息
合法值 说明
bad file descriptor 无效的文件描述符
fail permission denied 指定的 fd 没有写权限
fail the maximum size of the file storage limit is exceeded 存储空间不足
fail sdcard not mounted android sdcard 挂载失败

# 示例代码

const fs = wx.getFileSystemManager()
// 打开文件
fs.open({
  filePath: <code>${wx.env.USER_DATA_PATH}/hello.txt</code>,
  flag: 'a+',
  success(res) {
    // 对文件内容进行截断操作
    fs.ftruncate({
      fd: res.fd,
      length: 10, // 从第10个字节开始截断文件
      success(res) {
        console.log(res)
      }
    })
  }
})