文件-file
描述
文件，父对象为form，不可见，为功能性控件，无子对象。
事件
无
属性
名称 |
功能说明 |
脚本例子 |
|---|---|---|
path |
文件路径，用户可以访问/user目录下的板载存储空间，目前为48MB。如果需要访问U盘，也可设置为U盘路径 |
ui.form-name.file-name.path=’/user/test.txt’ 设置文件路径为/user/test.txt |
mode |
文件打开模式，值为整型（0-ReadWrite, 1-WriteOnly, 2-Append），默认值为 0 |
ui.form-name.file-name.mode=0 设置打开模式为可读可写 |
encoding |
文件操作的 字符编码格式 |
ui.form-name.file-name.encoding=’UTF-8’ 设置字符编码为UTF-8 |
方法
名称 |
功能说明 |
脚本例子 |
|---|---|---|
open() |
打开路径为属性path的文件，返回布尔值，true 表示打开成功 |
ui.form-name.file-name.open() 打开指定的文件 |
read(count) |
二进制方式读取count个字节 |
var a=ui.form-name.file-name.read(10) 从指定文件读取10个字节内容 |
readAll() |
二进制方式读取文件所有内容 |
var a=ui.form-name.file-name.readAll() 从指定文件读取所有内容 |
readLine() |
读取一行文本，行以’n’作为结束符 |
var a=ui.form-name.file-name.readLine() 从指定文件读取一行文本 |
readLines(index, count) |
读取指定索引行开始的多行内容，返回字符串 |
var a=ui.form-name.file-name.readLines(5,10)从第6行开始读取10行文本 |
readAllLines() |
读取全部行文本，行以’n’作为结束符 |
var a=ui.form-name.file-name.readAllLines() 从指定文件读取所有行文本 |
readStartLines(count) |
读取文本文件起始的几行，返回字符串数组，数组长度为count |
var a=ui.form-name.file-name.readStartLines(5); 读取文件开头的5行，返回为字符串数组 |
readEndLines(count) |
读取文本文件末尾的几行，返回字符串数组，数组长度为count |
var a=ui.form-name.file-name.readEndLines(5); 读取文件末尾的5行，返回为字符串数组 |
seek(offset) |
设置文件读写的偏移位置 |
ui.form-name.file-name.seek(10) 设置读写的偏移位置为10个字节 |
write(data) |
写入数据 |
ui.form-name.file-name.write(0xaa) 向指定文件写入16进制数aa |
writeAsync(data) |
异步方式写入数据 |
ui.form-name.file-name.writeAsync(0xaa)向指定文件写入16进制数aa |
writeLine(line) |
写入字符串行，自动添加’n’作为行结束符 |
ui.form-name.file-name.writeLine(‘this is a test’) 向指定文件写入文本行’this is a testn’ |
writeLineAsync(line) |
异步方式写入字符串行，自动添加’n’作为行结束符 |
ui.form-name.file-name.writeLineAsync(‘this is a test’) 向指定文件写入文本行’this is a testn’ |
close() |
关闭文件 |
ui.form-name.file-name.close() 关闭指定文件 |
sync() |
同步，强制缓存数据写入文件 |
ui.form-name.file-name.sync() 强制缓存数据写入指定文件 |
isOpen() |
返回文件是否已打开，只有打开的文件才能进行读，写，同步等操作 |
var opened=ui.form-name.file-name.isOpen() 返回指定文件是否已打开 |
atEnd() |
返回文件的读写位置是否已到文件尾 |
var a=ui.form-name.file-name.atEnd() 返回指定文件是否已读写到结尾 |
offset() |
返回文件的读写位置 |
var a=ui.form-name.file-name.offset() 返回指定文件读写位置 |
length() |
返回文件的大小 |
var l=ui.form-name.file-name.length() 返回指定文件大小 |
exists() |
返回指定文件是否存在 |
var l=ui.form-name.file-name.exists(‘/user/test.txt’) 检查/user/test.txt是否存在 |
isReadable() |
返回文件是否可读 |
var readable=ui.form-name.file-name.isReadable(‘/user/test.txt’) 检查/user/test.txt是否可读 |
isWritable() |
返回文件是否可写 |
var writable=ui.form-name.file-name.isWritable(‘/user/test.txt’) 检查/user/test.txt是否可写 |
copyTo(destination) |
拷贝指定文件到destination路径 |
ui.form-name.file-name.copyTo(‘/user/test.txt’) 将指定文件拷贝到’/user/test.txt’ |
rename(new_name) |
重新命名文件 |
ui.form-name.file-name.rename(‘/user/test2.txt’) 将文件重命名为test2.txt |
saveAsPdf(pdf_name) |
另存为PDF文件 |
ui.form-name.file-name.saveAsPdf(‘/storage/d0/test.pdf’) 另存为PDF到U盘 |
remove() |
删除当前文件 |
ui.form-name.file-name.remove() 删除当前文件 |