基础库 3.74.0 开始支持本方法，这是一个异步方法。

对文件内容进行截断操作

前提条件	无
业务背景	无
使用限制	无
注意事项	无
相关教程	无

语法

FileSystemManager.ftruncate(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	必填	说明	最低支持版本
length	number	是	截断位置，默认0。如果 length 小于文件长度（单位：字节），则只有前面 length 个字节会保留在文件中，其余内容会被删除；如果 length 大于文件长度，则会对其进行扩展，并且扩展部分将填充空字节（'\0'）	3.74.0
fd	string	是	文件描述符。fd 通过 FileSystemManager.open 或 FileSystemManager.openSync 接口获得	3.74.0
success	function	否	接口调用成功的回调函数	3.74.0
fail	function	否	接口调用失败的回调函数	3.74.0
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）	3.74.0

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"FileSystemManager.ftruncate:ok"	3.74.0

回调失败

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"FileSystemManager.ftruncate:fail" + 详细错误信息	3.74.0

错误码

errNo	errMsg	说明	最低支持版本
20001	invalid param	参数错误	3.74.0
21100	bad file descriptor	无效的文件描述符	3.74.0
21101	Path permission denied	传入的路径没有权限	3.74.0
21102	system error	小游戏框架内部错误，有需要请创建工单咨询	3.74.0
21103	the maximum size of the file storage limit is exceeded	存储空间不足，或文件大小超出上限	3.74.0
21104	illegal operation on a directory	不可对目录进行此操作（例如，指定的 filePath 是一个已经存在的目录）	3.74.0
21105	invalid fd	传入的 fd 无效，不是通过 open 打开获得的	3.74.0
21106	value of length is out of range	传入的 length 不合法	3.74.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

const fs = tt.getFileSystemManager();
const fd = fs.openSync({
  filePath,
  flag: "w+",
});
fs.ftruncate({
  fd,
  length: 1,
  success: (res) => {
    console.log("文件截断成功", res);
  },
  fail: (err) => {
    console.error("文件截断失败", err);
  },
});