Функция FileWriteLine

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

FileWriteLine

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

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

Параметры

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

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

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

Примечания

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

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

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

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

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

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

См. также

FileReadLine, FileOpen, FileRead, FileWrite

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

exect=$var_h=FileOpen('c:\Test\1.txt',1)||FileWriteLine($var_h,'Строка1')||FileClose($var_h) ;; пример записи в конец файла