Функция FileOpen

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

FileOpen

Открывает файл для чтения или записи.

FileOpen('filename'[,mode=0])

Параметры

filename

Имя файла для открытия.

mode

[необязательный] Режим, в котором будет открыт файл. Может быть комбинацией следующих значений:
0 = (по умолчанию) Открыть только для чтения
1 = Открыть только для записи в конец файла
2 = Открыть только для записи в конец файла, удалив предыдущее содержание
8 = Создать структуру папок, если путь к файлу не существует (см. примечания).
16 = Принудительно использовать бинарный режим (см. примечания).
32 = Использовать кодировку Unicode UTF16 Little Endian для чтения и записи. Чтение не перезаписывает существующую BOM.
64 = Использовать кодировку Unicode UTF16 Big Endian для чтения и записи. Чтение не перезаписывает существующую BOM.
128 = Использовать кодировку Unicode UTF8 (с BOM) для чтения и записи. Чтение не перезаписывает существующую BOM.
256 = Использовать кодировку Unicode UTF8 (без BOM) для чтения и записи.
16384 = Если при открытии файла не найдена метка BOM, проверять файл полностью, чтобы определить, является ли он файлом в кодировке UTF8. Если это значение флага не используется, тогда при определении того, является ли файл файлом в кодировке UTF8, будет проверено только начало файла.
Каталог назначения должен существовать (если не используется значение флага '8').

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

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

Примечания

По завершении использования файловый дескриптор необходимо закрыть с помощью функции FileClose().
Файл может не открыться из-за прав доступа и/или его атрибутов (R для флага 1, RSH для 2).
По умолчанию при записи текста используется режим ANSI, используйте флаги Unicode, чтобы изменить это. При записи файлов Unicode стандартный режим Windows (и самый быстрый в AutoIt из-за наименьшего преобразования) UTF16 Little Endian (флаг 32).
При открытии несуществующего файла для записи, он создаётся. Каталоги не создаются, если не используется соответствующий флаг.
Файл может быть прочитан как бинарные данные (по байтам), используя FileOpen() с соответствующим флагом. В этом случае длина определяется байтами, а не символами. Если будет прочитано слишком много данных, это приведёт к остановке AutoIt с ошибкой выделения памяти.

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

См. также

FileClose, FileRead, FileReadLine, FileWrite, FileWriteLine

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

exect=$var_h=FileOpen('c:\Test\1.txt',16)||$var_b=FileRead($var_h,5)||FileClose($var_h) GLOBALEXECT<a> ;; пример считывания 5 байтов из файла

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

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

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_h=FileOpen('c:\Test\1.txt')||FileReadLine($var_h,5)||FileClose($var_h) GLOBALEXECT<a> ;; пример считывания 5-й строки из текстового файла

exect=$var_h=FileOpen('%P%N',16)||$var_s=BinaryToString(FileRead($var_h),4)||FileClose($var_h)||_ViewValues('$var_s') ;; пример считывания данных файла под курсором в кодировке UTF-8