io.lines()

类型 函数
函数库 io.*
返回值 函数（迭代器）
修订版 Release 2024.3703
关键字 io、lines、file
另请参阅 io.input()

概述

以读取模式打开给定文件名称并返回一个迭代器函数，每次调用该函数时，它会从文件中返回一个新行。

该函数将打开此文件并在该文件的全部行上进行迭代。当迭代器函数检测到文件结束时，它将返回 nil（结束循环）然后自动关闭文件。

不带文件调用 io.lines() 与 io.input():lines() 类似；也就是说，它会迭代默认输入文件的行，但它不会在循环结束时关闭文件。

此函数返回一个迭代器函数，每次调用此函数时，它会从文件中返回一个新行。

语法

io.lines( file )
file （必需）

对象. 要读取的文件。你必须使用 system.pathForFile() 为 system.ResourceDirectory、system.DocumentsDirectory、system.ApplicationSupportDirectory、system.TemporaryDirectory 或 system.CachesDirectory 常量 创建一个文件名称及路径。

示例

local path = system.pathForFile( "data.txt", system.DocumentsDirectory )

for line in io.lines( path ) do
    print( line )
end