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


FileWrite

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

FileWrite ( "filehandle/filename", "text/data" )

Параметры

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

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

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

Примечания

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

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

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

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

Если данные бинарного типа (а не текста), то в файл записывается байт за байтом. Бинарная операция также принудительно используется функцией FileOpen с флагом соответствующим бинарному режиму.

См. также

FileFlush, FileOpen, FileRead, FileReadLine, FileWriteLine, Binary, FileSetPos, FileGetPos

Пример

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

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

FileWrite($hFile, "Строка1")
FileWrite($hFile, "всё же Строка1" & @CRLF)
FileWrite($hFile, "Строка2")

FileClose($hFile)