Справочник по функциям работы с файлами

Материал из DRKB


Содержимое файла[править | править код]

function FileOpen(const FileName: string; Mode: Word): Integer;

Открывает существующий FileName файл в режиме Mode Значение, возвращаемое в случае успеха, - дескриптор открытого файла. В противном случае - код ошибки DOS.


function FileCreate(const PileName: string): Integer;

Создает файл с именем FileName. Возвращает то же, что и FileOpen.


function FileRead(Handle: Integer; var Buffer; Count: Longint): Longint;

Считывает из файла с дескриптором Handle Count байт в буфер Buffer. Возвращает число реально прочитанных байт или -1 при ошибке.


function FileWrite(Handle: Integer; const Buffer);

Записывает в файл с дескриптором Handle Count байт из буфера Buffer. Возвращает число реально записанных байт или -1 при ошибке.


function FileSeek(Handle: Integer; Offset: Longint; Origin: Integer): Longint;

Позиционирует файл с дескриптором Handle в новое положение. При Origin = 1,2,3 положение смещается на Offset байт от начала файла, текущей позиции и конца файла соответственно. Возвращает новое положение или -1 при ошибке.


procedure FileClose(Handle: Integer);

Закрывает файл с дескриптором Handle.


Манипуляции над файлом[править | править код]

function FileExists(const FileName: String): Boolean;

Возвращает True если файл FileName существует к найден.


function DeleteFile(const FileName: String): Boolean;

Уничтожает файл с именем FileName и в случае успеха возвращает True.


function RenameFile(const OldName, NewName: string): Boolean;

Переименовывает файл с именем OldName в NewName и возвращает True в случае успеха.


Поиск файлов[править | править код]

function FindFirst(const Path: string; Attr: Integer; var SearchRec: TSearchRec): Integer;

Ищет первый файл, удовлетворяющий маске поиска, заданной в Path и с атрибутами Attr. В случае успеха заполняет запись SearchRec (см. примеч. 3) и возвращает 0, иначе возвращает код ошибки DOS.


function FindNext(var SearchRec: TSearchRec): Integer;

Продолжает процесс поиска файлов, удовлетворяющих маске поиска. Параметр SearchRec должен быть заполнен при помощи FindFirst. Возвращает 0, если очередной файл найден, или код ошибки DOS. Изменяет SearchRec.


procedure FindClose(var SearchRec: TSearchRec);

Завершает процесс поиска файлов, удовлетворяющих маске поиска.


function FileSearch(const Name, DirList: string): strings;

Производит поиск файла с именем Name в группе каталогов, заданных параметром DirList. Имена каталогов должны отделяться друг от друга точкой с запятой. Возвращает в случае успеха полное имя файла или пустую строку, если файл не найден.


Свойства файла[править | править код]

function FileAge(const FileName: String)

Возвращает значения даты и времени создания файла или -1, если файл не существует.


function FileGetDate(Handle: Integer): Longint;

Возвращает время создания файла с дескриптором Handle (в формате DOS) или -1, если дескриптор недействителен.


procedure FileSetDate(Handle: Integer);

Устанавливает время создания файла с дескриптором Handle (в формате DOS).


function FileGetAttr(const FileName: string): Integer;

Возвращает атрибуты (см. примеч. 2) файла с именем FileName или код ошибки DOS, если файл не найден.


function FileSetAttr(const FileName: string; Attributes: Integer): Integer;

Устанавливает атрибуты файла с именем FileName.


Преобразование пути и имени файла[править | править код]

function ChangeFileExt(const FileName, Extension: string): string;

Изменяет расширение в имени файла FileName на Extension и возвращает новое значение FileName. Имя файла не изменяется.


function ExtractFilePath(const FileName: string): string;

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


function ExtractFileName(const FileName: string): string;

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


function ExtractFileExt(const FileName: string): string;

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


function ExpandFileName(const FileName: string): string;

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


Преобразование даты и времени файла[править | править код]

function FileDateToDateTime(FileDate: Longint): TDateTime;

Преобразует дату и время в формате DOS в принятый в Delphi формат TDateTime.


function DateTimeToFileDate(DateTime: TDateTime): Longint;

Преобразует дату и время из формата TDateTime в формат DOS.


Информация о дисках[править | править код]

function DiskFree(Drive: Byte): Longint;

Возвращает количество в байтах свободного места на заданном диске. Значение параметра Drive: 0 - для текущего диска, 1 - для А, 2 - для В и т. д. Если параметр неверен, функция возвращает -1.


function DiskSize(Drive: Byte): Longint;

Возвращает размер диска Drive в байтах. Параметр Drive означает то же, что и в DiskFree.


ID: 03180