readFile

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

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

params

sync：

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

path：

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

callback(ret, err)

ret：

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

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

err：

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

{
    code:0,             //錯誤碼
    msg:""              //錯誤描述
}


code取值范圍:


0            //沒有錯誤
1            //找不到文件錯誤
2            //不可讀取錯誤
3            //編碼格式錯誤
4            //無效操作錯誤
5            //無效修改錯誤
6            //磁盤溢出錯誤
7            //文件已存在錯誤

示例代碼

//異步返回結(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及更高版本