Справочник по функциям работы с файлами
Материал из 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