Функция FileReadLine

Описание функции

FileReadLine

Считывает строку текста из текстового файла.

FileReadLine('filehandle/filename'[,line=1])

Параметры

filehandle/filename	Дескриптор файла, возвращённый функцией FileOpen() или путь к файлу.
line	[необязательный] Номер строки для чтения. Номер первой строки 1 (а не 0), последней строки -1.

Возвращаемое значение

Успех:	Возвращает прочитанную строку.
Особенность:	Устанавливает значение @error равным -1 при достижении конца файла.
Ошибка:	Устанавливает значение @error равным 1, если файл не открыт в режиме для чтения или произошла какая-либо другая ошибка.

Примечания

Возвращает прочитанную строку текста. Любые символы новой строки ( Chr(10) или @LF ) в конце строки автоматически удаляются.
Если не указан номер строки для чтения, будет прочитана следующая строка ("следующая" строка для вновь открытого файл, это его первая строка).
Если в качестве первого параметра будет передан путь к файлу, а не его дескриптор, то во время вызова функции файл будет открываться, а по завершении её работы - закрываться. При работе с большими текстовыми файлами это может оказаться намного медленнее, чем использование дескриптора файла.
Обратите внимание, что не надо смешивать использование дескрипторов файлов и имён файлов. Т.е. не надо сначала использовать FileOpen() для открытия файла, а потом использовать имя файла в этой функции. Используйте либо дескриптор, либо имя файла в своих программах, но не оба вперемешку!

С точки зрения производительности, использовать эту функцию в цикле, увеличивая параметр line на 1 при в каждом шаге цикла - является плохой идеей. Это заставляет AutoIt перечитывать файл с самого начала до указанной строки.

AutoIt может корректно считывать текст как из файлов в кодировке ANSI, так и в кодировке UTF16/UTF8.

Функцию можно подключить через команду exect

См. также

FileWriteLine, FileOpen, FileRead, FileWrite

Примеры:
Как создать кнопку?

exect=$var_h=FileOpen('c:\Test\1.txt')||FileReadLine($var_h,5)||FileClose($var_h) GLOBALEXECT<a> ;; пример считывания 5-й строки из текстового файла

exect=$var_sline=FileReadLine('c:\Test\1.txt',4) GLOBALEXECT<a> ;; пример считывания 4-й строки из текстового файла

exect=_ViewValues(FileReadLine('%P%N',-1)) ;; получить последнюю строку файла под курсором