FileReadLine

读取文件指定行的文本并保存到变量。

FileReadLine, OutputVar, Filename, LineNum

参数

OutputVar

用来存储获取的文本的 变量 名.

Filename

要访问的文件名, 如果未指定绝对路径则假定在 %A_WorkingDir% 中. 支持 Windows 和 Unix 格式; 即文件的行结束符可以是回车和换行符 (`r`n) 或只是换行符 (`n).

LineNum

要读取的行号 (首行为 1, 第二行为 2, 依此类推). 可以为 表达式.

如果指定的行号大于文件的行数, 则 ErrorLevel 被设置为 1 且 OutputVar 不会发生变化. 当指定的行号为文件的最后一行且此行为空, 同时不是以新行/CRLF 结束时, 也会发生这种情况.

ErrorLevel

[v1.1.04+] 此命令失败时会抛出异常. 想了解更多信息, 请参阅 运行时错误.

成功时 ErrorLevel 被置为 0. 否则它被设置为 1 且 OutputVar 的原始内容不会发生变化.

A_LastError 被设置为操作系统 GetLastError() 函数返回的结果.

备注

强烈建议仅对于小文件或只需要单行文本的情况时使用此命令. 要扫描并处理大量的文本行 (一行接一行), 请使用 文件读取循环 来获取最好的性能. 要读取整个文件到变量中, 请使用 FileRead.

虽然一行中任何前导和尾随的 tab 和空格都会被写入 OutputVar, 但是行末的换行符 (`n) 则不会. 当 AutoTrim 设置打开 (默认的) 时, 任何变量都可以通过赋值给自己来移除变量两端的 tab 和空格. 例如：MyLine = %MyLine%。

最大可以读取包含 65,534 字符的长行. 如果行的超度超过这个极限, 则此命令无法读取剩余的字符 (此时应使用 FileRead 或 文件读取循环 代替).

相关

FileOpen/File.ReadLine(), FileRead, FileAppend, 文件读取循环, IniRead

示例

Loop
{
    FileReadLine, line, C:\My Documents\ContactList.txt, %A_Index%
    if ErrorLevel
        break
    MsgBox, 4, , Line #%A_Index% is "%line%".  Continue?
    IfMsgBox, No
        return
}
MsgBox, The end of the file has been reached or there was a problem.
return