逐行读取文件文本内容

fs.readLines(Promise异步返回)

readLines(filePath: string, options?: Options): Promise

逐行读取文件文本内容，使用Promise异步返回，只支持读取utf-8格式文件。

参数：

参数名	类型	必填	说明
filePath	string	是	文件的应用沙箱路径。
options	Options	否	可选项。支持以下选项： - encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 ‘utf-8’，仅支持 ‘utf-8’。

返回值：

类型	说明
Promise	Promise对象。返回文件读取迭代器。

错误码：

接口抛出错误码的详细介绍请参见基础文件IO错误码。

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { fileIo as fs, Options } from '@kit.CoreFileKit';
let filePath = pathDir + "/test.txt";
let options: Options = {
  encoding: 'utf-8'
};
fs.readLines(filePath, options).then((readerIterator: fs.ReaderIterator) => {
  for (let it = readerIterator.next(); !it.done; it = readerIterator.next()) {
    console.info("content: " + it.value);
  }
}).catch((err: BusinessError) => {
  console.error("readLines failed with error message: " + err.message + ", error code: " + err.code);
});

fs.readLines(Callback异步返回)

readLines(filePath: string, options?: Options, callback: AsyncCallback): void

逐行读取文件文本内容，使用callback异步回调，只支持读取utf-8格式文件。

参数：

参数名	类型	必填	说明
filePath	string	是	文件的应用沙箱路径。
options	Options	否	可选项。支持以下选项： - encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 ‘utf-8’，仅支持 ‘utf-8’。
callback	AsyncCallback	是	逐行读取文件文本内容回调。

错误码：

接口抛出错误码的详细介绍请参见基础文件IO错误码。

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { fileIo as fs, Options } from '@kit.CoreFileKit';
let filePath = pathDir + "/test.txt";
let options: Options = {
  encoding: 'utf-8'
};
fs.readLines(filePath, options, (err: BusinessError, readerIterator: fs.ReaderIterator) => {
  if (err) {
    console.error("readLines failed with error message: " + err.message + ", error code: " + err.code);
  } else {
    for (let it = readerIterator.next(); !it.done; it = readerIterator.next()) {
      console.info("content: " + it.value);
    }
  }
});

fs.readLinesSync(同步)

readLinesSync(filePath: string, options?: Options): ReaderIterator

以同步方式逐行读取文件文本内容。

参数：

参数名	类型	必填	说明
filePath	string	是	文件的应用沙箱路径。
options	Options	否	可选项。支持以下选项： - encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 ‘utf-8’，仅支持 ‘utf-8’。

返回值：

类型	说明
ReaderIterator	返回文件读取迭代器。

错误码：

接口抛出错误码的详细介绍请参见基础文件IO错误码。

示例：

import { fileIo as fs, Options } from '@kit.CoreFileKit';
let filePath = pathDir + "/test.txt";
let options: Options = {
  encoding: 'utf-8'
};
let readerIterator = fs.readLinesSync(filePath, options);
for (let it = readerIterator.next(); !it.done; it = readerIterator.next()) {
  console.info("content: " + it.value);
}