Функции работы с файлами

Функция ChangeFileExt изменяет расширение файла, указанного <FileSource> на <Ext>. Имя файла задаётся полностью, через запятую задаётся новоё расширение. Обязательные параметры:

• <FileSource> - Полное имя файла вместе с расширением, может включать путь
• <Ext> - новое расширение файла

Возвращаемое значение - символьное: новое полное имя файла с новым расширением.

Функция CopyFile обеспечивает дублирование закрытого файла любого типа.

<InFile> будет скопирован в <OutFile>. Имена обеих файлов следует указывать с расширением. Нельзя использовать команду для копирования открытого файла.

Дополнительно можно указать следующие необязательные параметры:

• <From> - смещение файла от начала в символах
• <Count> - количество копируемых символов

Если файл скопирован, то функция вернёт .T., если нет, то .F.

Функция DeleteFile удаляет файл заданный файловым именем <FileName>. Файл ищется в текущей директории.

Если файл был удален, то возвращается .T., в противном случае возвращается .F..

Относится к функциям низкого уровня для работы с файлами. Она разгружает буфер в файл на диске и закрывает его.

Ссылочный номер файла создается при создании файла функцией FCREATE() или открытии функцией FOPEN().

При успешном закрытии функция возвращает истину .T. и освобождает ссылочный номер файла. В случае невозможности закрытия возвращается ложь .F.

Относится к функциям низкого уровня для работы с файлами. Она создает новый файл с именем вырС и открывает его.

Если файл с таким именем уже существует, он перекрывается новым. В процессе работы функции файлу назначается ссылочный номер для возможности обращения к нему с помощью других функций низкого уровня. Этот номер возвращается функцией.

В вырС можно задать дисковод и маршрут файла. Если они не заданы, файл создается в директории, принятом по умолчанию. Создаваемому файлу можно назначить атрибуты, для этого предназначен необязательный параметр вырN. Hиже приведен список возможных значений этого параметра.

0 - Чтение и запись (принимается по умолчанию)

1 - Только чтение

2 - Скрытый файл

3 - Только чтение, Скрытый файл

4 - Системный файл

5 - Только чтение, Системный файл

6 - Системный файл, Скрытый файл

7 - Только чтение, Скрытый файл, Системный файл

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

Возвращает дату или дату и время последнего изменения файла, имеющего имя <File1>. Имя файла может включать путь.

<Mode>, может принимать следующие значения:

• 0 - функция вернет дату (по умолчанию)
• 1 - функция вернет дату и время

Относится к функциям низкого уровня для работы с файлами. Она возвращает истину .T., если указатель файла позиционируется на конце файла.

В качестве аргумента используется ссылочный номер файла. Если указатель файла не находится на конце файла, функция возвращает ложь .F. .

При совместном использовании с функцией FSEEK() данная функция помогает выявить, что файл пустой.

Возвращает последовательность байтов из файла со ссылочным номером вырN1.

Аналогично функции FREAD(), функция FGETS() возвращает серию байтов, но до того момента, пока не встретится символ возврата каретки. Циклическое использование функции позволяет считывать файл строка за строкой.

FGETS() возвращает последовательность байтов как символьную строку. Последовательность начинается с байта, на который указывает указатель записи, и заканчивается возвратом каретки. После этого указатель записи перемещается на байт, непосредственно следующий за возвратом каретки. Символ перевола строки игнорируется функцией FGETS().

Можно специфицировать количество байтов, возвращаемое функцией, посредством необязательного аргумента вырN2. Тогда будет возвращено именно такое количество байт, если только раньше не встретится возврат каретки. Если же возврат каретки встратился внутри вырN2 байтов, то возвращаются байты, начиная с указателя записии и до символа возврата каретки.

Если вырN2 не указано, предполагается по умолчанию чтение до 254 байтов.

вырN1 - Ссылочный номер файла или порт.

вырN2 - Количество символоов строки, которое пишется в файл или порт.

Вcтавить в начало <Файл> текст <Строка>. Возвращаемое значение - цифровое, количество вставленных символов.

Имя файла <Файл> может включать полный маршрут файла с указанием дисковода. Если полный маршрут не указан, то ищем файл в текущей папке, принятой по умолчанию

Возвращает логическое значение "истина" (.T.), если символьное выражение файл является именем существующего файла. Если такого файла нет, функция возвращает значение "ложь" (.F.).

Имя файла должно быть указано с расширением.

Функция выполняет поиск файла только в текущем директории. Для поиска в других директориях, имени файла должен предшествовать полный маршрут поиска в соответствии с правилами, установленными в операционной системе.

Имя файла может быть строковой константой (должно быть заключено в кавычки), значением временной переменной символьного типа, символьным выражением.

Открывает файл или порт для использования на низком уровне. Возвращаемое значение - числовое

Имя файла вырС может включать полный маршрут файла с указанием дисковода. Если полный маршрут не указан, то ищем файл в текущей папке, принятой по умолчанию

Пишет символьную строку в файл или порт, в конце ставит перевод строки/возврат каретки. Возвращаемое значение - числовое

Функция аналогична FWRITE(), но в конце последовательности символов, записываемых в файл, она помещает символы возврата каретки и перевода строки.

вырN1 - Ссылочный номер файла или порт.

вырC> - выводимая строка.

вырN2 - Количество символоов строки, которое пишется в файл или порт.

Возвращает указанное количество байтов из файла или порта. Возвращаемое значение - символьное

FREAD начинает возврат байтов с текущей позиции указателя и останавливается после возврата вырN2 байт или по достижению конца файла. В последнем случае возвращается меньшее, чем вырN2 количество байтов.

вырN1 - Ссылочный номер файла или порт.

вырN2 - Количество возвращаемых байт.

Перемещение указателя в файле, открытом с помощью функции низкого уровня. Возвращаемое значение - числовое

FSEEK() возвращает текущую позицию указателя файла относительно начала файла после перемещеия указателя.

вырN1 - Ссылочный номер файла.

вырN2 - сколько байт переместить указатель.

вырN3 - Перемещение указателя:

0 - Смещение относительно начала файла (по умолчанию)

1 - Смещение относительно текущей позиции указателя

2 - Смещение относительно конца файла

Возвращает время последнего изменения файла, имеющего имя <File1>. Имя файла может включать путь. Возвращаемое значение - символьное

Функция возвращает полное имя файла <FileName>,. Возвращаемое значение - символьное.

Функция добавляет к имени текущего каталога имя файла, указанное в параметре <FileName>,. Совершенно необязательно, чтобы указанный файл существовал.

Пишет символьную строку в файл или порт. Возвращаемое значение - числовое.

FWRITE() позволяет писать в файл или порт, сылочный номер которых указывается в вырN1.

Пишется вся строка вырC, если не указан необязательный аргумент вырN2, который определяет, количество символов, которое будет писаться в файл или порт. Если вырN2 больше числа символов в строке, пишется вся строка, если меньше, пишутся только первые вырN2 символов.

FWRITE() возвращает число байт, записанных в файл или порт. Если функция завершилась безуспешно, возвращается 0.

Функция JustDrive(<FullFileName>) Извлекает имя диска из полного имени файла. Возвращаемое значение - символьное.

Функция JustExt(<FullFileName>) Извлекает расширение из полного имени файла. Возвращаемое значение - символьное.

Функция JustFname(<FullFileName>) Извлекает имя файла из полного имени файла. Возвращаемое значение - символьное.

Функция JustPath(<FullFileName>) Извлекает путь из полного имени файла. Возвращаемое значение - символьное.

Функция JustStem(<FullFileName>) Извлекает имя файла без расширения из полного имени файла. Возвращаемое значение - символьное.

Выполняет изменение имени файла на диске.

Старое <файл1> и новое имя <файл2> файла должны включать расширение имени. Если файлы расположены на диске, отличном от активного по умолчанию, именам файлов должен предшествовать идентификатор диска и маршрут.

Hовое имя файла не может совпадать с именем существующего файла, расположенного в том же директории..

Запрещается изменять имя открытого файла

Если файл был переименован, то возвращается .T., в противном случае возвращается .F..

Функция Zip создает Zip-архив <Arc>, состоящий из файлов <File1>...<File50>, т.е. в архив можно добавить до 50-ти файлов.

Если архив создан, то возвращает количество заархивированных файлов .