# FileSystemManager.ftruncate(Object object)

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

以 Promise 风格调用：不支持

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

# 功能描述

对文件内容进行截断操作

# 参数

# Object object

属性	类型	必填	说明
fd	string	是	文件描述符。fd 通过 FileSystemManager.open 或 FileSystemManager.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)
      }
    })
  }
})