FileReadLine()
OutputVar := Mfunc.FileReadLine(Filename, LineNum)
Reads the specified line from a file and returns the text.
Filename
The name of the file to access, which is assumed to be in %A_WorkingDir% if an absolute path isn't specified. Windows and Unix formats are supported; that is, the file's lines may end in either carriage return and linefeed (`r`n) or just linefeed (`n).
Can be MfString instance or var containing string.
LineNum
Which line to read (1 is the first, 2 the second, and so on). This can be an expression.
If the specified line number is greater than the number of lines in the file, ErrorLevel is set to 1 and Return value is not changed. This also happens when the specified line number is the last line in the file but that line is blank and does not end in a newline/CRLF.
Can be MfInteger instance or var containing integer.
Returns the retrieved text.
Throws MfException is non-zero then InnerException has a message of A_LastError.
If the specified line number is greater than the number of lines in the file then MfException is thrown with InnerException. This also happens when the specified line number is the last line in the file but that line is blank and does not end in a newline/CRLF.
Wrapper for AutoHotkey Docs - FileCreateDir.
Static method.
It is strongly recommended to use this command only for small files, or in cases where only a single line of text is needed. To scan and process a large number of lines (one by one), use a file-reading loop for best performance. To read an entire file into a variable, use Mfunc.FileRead.
Although any leading and trailing tabs and spaces present in the line will be written to return value, the linefeed character (`n) at the end of the line will not. Tabs and spaces can be trimmed from both ends of any variable by assigning it to itself while AutoTrim is on (the default). For example:
MyLine = %MyLine%.
Lines up to 65,534 characters long can be read. If the length of a line exceeds this, the remaining characters cannot be retrieved by this method.
See Also:AutoHotkey Docs - FileCreateDir.
Loop
{
try
{
line := Mfunc.FileReadLine("C:\My Documents\ContactList.txt", A_Index)
}
catch e
{
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