微信小游戏开发文档-小游戏文件API FileSystemManager.readFile(Object object)
FileSystemManager.readFile(Object object)
读取本地文件内容
参数
Object object
从文件指定位置开始读,如果不指定,则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围:[0, fileLength - 1]。单位:byte
| 属性 |
类型 |
是否必填 |
说明 |
支持版本 |
| filePath |
string |
是 |
要读取的文件的路径 |
|
| encoding |
string |
否 |
指定读取文件的字符编码 |
|
| position |
string |
否 |
从文件指定位置开始读,如果不指定,则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围:[0, fileLength - 1]。单位:byte |
2.10.0 |
| length |
string |
否 |
指定文件的长度,如果不指定,则读到文件末尾。有效范围:[1, fileLength]。单位:byte |
2.10.0 |
| success |
function |
否 |
接口调用成功的回调函数 |
|
| fail |
function |
否 |
接口调用失败的回调函数 |
|
| complete |
function |
否 |
接口调用结束的回调函数(调用成功、失败都会执行) |
|
object.encoding 的合法值
| 值 |
说明 |
| ascii |
|
| base64 |
|
| binary |
|
| hex |
|
| ucs2/ucs-2/utf16le/utf-16le |
以小端序读取 |
| utf-8/utf8 |
|
| latin1 |
|
object.success 回调函数
参数
Object res
| 属性 | 类型 | 说明 |
|---|
| data | string/ArrayBuffer | 文件内容 |
fail 回调函数
参数
Object res
| 属性 |
类型 |
说明 |
支持版本 |
| errMsg |
string |
错误信息 |
|
res.errMsg 的合法值
| 值 |
说明 |
| fail no such file or directory, open ${filePath} |
指定的 filePath 所在目录不存在 |
| fail permission denied, open ${dirPath} |
指定的 filePath 路径没有读权限 |