Оригинал статьи в AutoHotkey.chm: "FileReadLine", в содержании - "File, Directory and Disk Management" - "FileReadLine", v1.0.46.07.

Ник переводчика: Дед Мазай.

Настоящее имя переводчика: Антон Иваненко, г.Москва.

FileReadLine

Читает определённую строку в файле и помещает текст в переменную.

FileReadLine, OutputVar, Filename, LineNum

Параметры

OutputVar	Имя переменной, в которую будет помещен полученный текст.
Filename	Имя и путь к файлу, к которому обращена команда. Если путь файла не указан, по дефолту он будет считан с переменной %A_WorkingDir%. Поддерживаются Windows и Unix форматы, т.е. строки текста в файле могут оканчиваться возвратом каретки и переводом строки (`r`n) или просто переводом строки (`n).
LineNum	Номер считываемой строки (1 для первой, 2 для второй и так далее). Также может быть представлено в виде выражения.

ErrorLevel

ErrorLevel в случае возникновения проблемы принимает значение 1, и 0 - если проблем нет.

Примечания

В целом эта команда направлена на использование преимущественно с файлами малого размера, или в случаях, когда необходимо прочтение только какой-то одной строки. Если вам необходимо просканировать и обработать большое количество строк (одну за одной), для лучшей производительности используйте file-reading loop. Для того, чтобы прочитать и поместить в переменную весь файл целиком, используйте FileRead.

Табуляции и пробелы в начале строк, представленные в файле, также помещаются в нашу переменную OutputVar, а вот маркер переноса строки (`n) – нет. Табуляции и пробелы с обоих концов строки могут быть обрезаны с помощью команды AutoTrim, которая по дефолту имеет статус On (включена). Например: Var1 = %Var2%, табуляции и пробелы в начале и конце строк переменой Var2 обрезаются при переносе данных в переменную Var1.

Могут читаться строки длиной до 65534 символов. Если строка длиннее, остальные символы будут обрезаны (в таких случаях используйте FileRead или file-reading loop).

Пример

Loop
{
    FileReadLine, line, C:\My Documents\ContactList.txt, %A_Index%
    if ErrorLevel
        break
    MsgBox, 4, , Строка №%A_Index%: "%line%".  Продолжить?
    IfMsgBox, No
        return
}
MsgBox, Достигнут конец файла или возникла проблема чтения.
Return

Перейти на главную страничку сайта (список статей, файлы для скачивания)