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


FileWriteLine

Записывает строку текста в конец файла.

FileWriteLine ( "filehandle/filename", "line" )

Параметры

filehandle/filename Дескриптор файла, возвращаемый функцией FileOpen(). Также, можно использовать полный путь или имя файла.
line Текст для записи в файл. Если он НЕ заканчивается символом @CR или @LF, тогда новая строка в стиле DOS (@CRLF) автоматически будет добавлена.

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

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

Примечания

Если файл открыт функцией FileOpen(), то он должен быть открыт в режиме для записи, иначе функция FileWriteLine() вернёт ошибку.

Если в качестве первого параметра будет передан путь к файлу, а не его дескриптор, то во время вызова функции файл будет открываться, а по завершении её работы - закрываться. При работе с большими текстовыми файлами это может оказаться намного медленнее, чем использование дескриптора файла. Если файл с указанным именем не существует, он будет создан.

Обратите внимание, что не нужно смешивать использование дескрипторов файлов и имён файлов. То есть не нужно использовать имя файла в функции FileWriteLine(), если файл был открыт с помощью FileOpen(). Либо используйте дескриптор, либо имя файла, но не оба вместе.

При записи текста AutoIt'ом по умолчанию используется ANSI. Для записи в режиме Unicode файл должен быть открыт функцией FileOpen() с соответствующими флагами.

Записываемый текст не может содержать символы Chr(0), которые обрезаются. Используйте FileWrite(), открыв файл в бинарном режиме для записи таких символов.

См. также

FileReadLine, FileFlush, FileOpen, FileRead, FileWrite, FileSetPos, FileGetPos

Пример

$hFile = FileOpen("test.txt", 1)

; Проверяет, является ли файл открытым, перед тем как использовать функции чтения/записи в файл
If $hFile = -1 Then
    MsgBox(4096, "Ошибка", "Невозможно открыть файл.")
    Exit
EndIf

FileWriteLine($hFile, "Строка1")
FileWriteLine($hFile, "Строка2" & @CRLF)
FileWriteLine($hFile, "Строка3")

FileClose($hFile)