Функция FileWrite

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

FileWrite

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

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

Параметры

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

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

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

Примечания

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

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

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

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

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

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

См. также

FileOpen, FileRead, FileReadLine, FileWriteLine

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

exect=$var_h=FileOpen('c:\Test\1.txt',1)||FileWrite($var_h,'Строка1'&@CRLF&'Строка2')||FileClose($var_h) GLOBALEXECT<a> ;; пример записи в конец файла многострочного текста

exect=$var_sp='c:\Test\1.txt'||$var_st=FileRead('$var_sp')||$var_h=FileOpen('$var_sp',2)||FileWrite($var_h,'Строка1'&'$var_st')||FileClose($var_h) GLOBALEXECT<a> ;; пример записи в начало файла

exect=$var_s=##[input=BOX72]||$var_ap=_ArrayPermute(StringSplit('$var_s',Null,2))||_ViewValues($var_ap)||$var_ss=_ArrayToString($var_ap,@CRLF,1)||_ViewValues('$var_ss ')||FileWrite('c:\Test\anagam.txt','$var_ss') ;; создание анаграммы в введённого слова в диалоге, просмотр результата на каждом этапе и сохранение в файл anagam.txt (В анаграмму входят слова, с перестановкой всех букв заданного слова без повторов букв и точной длины)
exect=$var_s=##[input=BOX72]||FileWrite('c:\Test\anagam.txt',_ArrayToString(_ArrayPermute(StringSplit('$var_s',Null,2)),@CRLF,1)) ;; создание анаграммы в введённого слова в диалоге и сохранение в файл anagam.txt

exect=$var_s=##[input=BOX72]||FileWrite('c:\Test\anagam_'&'$var_s'&'.txt',_ArrayToString(_ArrayPermute(StringSplit('$var_s',Null,2)),@CRLF,1)) ;; создание анаграммы в введённого слова в диалоге и сохранение в файл anagam_слово.txt