readFile

讀取文本文件內(nèi)容，只支持utf-8編碼文本類(lèi)型文件

readFile({params}, callback(ret, err))

params

sync：

• 類(lèi)型：布爾
• 默認(rèn)值：false
• 描述：執(zhí)行結(jié)果的返回方式。為false時(shí)通過(guò)callback返回，為true時(shí)直接返回。

path：

• 類(lèi)型：字符串
• 默認(rèn)值：無(wú)
• 描述：文件路徑，支持絕對(duì)路徑和文件路徑協(xié)議如fs://、widget://等

callback(ret, err)

ret：

• 類(lèi)型：JSON 對(duì)象
• 內(nèi)部字段：

{
    status:true,        //操作成功狀態(tài)值
    data:""             //文件內(nèi)容，字符串類(lèi)型
}

err：

• 類(lèi)型：JSON 對(duì)象
• 內(nèi)部字段：

{
    code:0,             //錯(cuò)誤碼
    msg:""              //錯(cuò)誤描述
}


code取值范圍:


0            //沒(méi)有錯(cuò)誤
1            //找不到文件錯(cuò)誤
2            //不可讀取錯(cuò)誤
3            //編碼格式錯(cuò)誤
4            //無(wú)效操作錯(cuò)誤
5            //無(wú)效修改錯(cuò)誤
6            //磁盤(pán)溢出錯(cuò)誤
7            //文件已存在錯(cuò)誤

示例代碼

//異步返回結(jié)果：
api.readFile({
    path: 'fs://a.txt'
}, function(ret, err) {
    if (ret.status) {
        var data = ret.data;
    } else {
        api.alert({
            msg:JSON.stringify(err)
        });
    }
});


//同步返回結(jié)果：
var data = api.readFile({
    sync: true,
    path: 'fs://a.txt'
});

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.0.0及更高版本