string|ArrayBuffer FileSystemManager.readFileSync(string filePath, string encoding, number position, number length)

FileSystemManager.readFile 的同步版本

参数

string filePath

要读取的文件的路径 (本地路径)

string encoding

指定读取文件的字符编码,如果不传 encoding,则以 ArrayBuffer 格式读取文件的二进制内容

encoding 的合法值

说明最低版本
ascii
base64
binary
hex
ucs2以小端序读取
ucs-2以小端序读取
utf16le以小端序读取
utf-16le以小端序读取
utf-8
utf8
latin1

number position

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

从文件指定位置开始读,如果不指定,则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围:[0, fileLength - 1]。单位:byte

number length

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

指定文件的长度,如果不指定,则读到文件末尾。有效范围:[1, fileLength]。单位:byte

返回值

string|ArrayBuffer data

文件内容

错误

错误码错误信息说明
fail no such file or directory, open ${filePath}指定的 filePath 所在目录不存在
fail permission denied, open ${dirPath}指定的 filePath 路径没有读权限
fail sdcard not mountedAndroid sdcard 挂载失败