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

E_OPEN()

E_FILE* E_OPEN(char *name, int flags)

Параметры:

char *name – указатель на набор данных, который необходимо открыть

int flags – указывает способ открытия набора данных (открыть только для чтения, открыть только для записи, открыть для чтения и для записи)

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

Указатель на дескриптор, с которым будет связан открываемый набор данных

NULL – если файл с именем name не существует или другая ошибка

Описание:

Функция открывает набор данных с именем name на чтение или на запись, или на то и другое в зависимости от значения flags.

Файл с именем name должен существовать.

E_CLOSE()

int E_CLOSE(E_FILE *fd)

Параметры:

E_FILE *fd – указатель на дескриптор набора данных

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

0 – успешное завершение

Иначе - ошибка

Описание:

Функция разрывает связь между дескриптором fd и связанным с ним набором данных.

E_WRITE()

int E_WRITE(E_FILE *fd, char *buf, int n, struct rec_addr *addr)

Параметры:

E_FILE *fd – указатель на дескриптор набора данных

char *buf - символьный массив, из которого поступают данные

struct rec_addr *addr – указатель на структуру rec_addr, в которой содержится адрес куда была записана новая запись (номер цилиндра, номер трэка)

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

Число успешно записанных байт

-1 – Ошибка

Описание:

Функция записывает данные из buf в набор данных который связан с fd и помещает в addr адрес сделанной записи (номер тцилиндра, номер трэка)

E_READ()

int E_READ(E_FILE *fd, char *buf, int n, struct rec_addr *addr)

Параметры:

E_FILE *fd – указатель на дескриптор набора данных

char *buf - символьный массив, в который поступают данные

strcut rec_addr *addr – указатель на структуру rec_addr, в которой содержится адрес откуда была считанна запись (номер цилиндра, номер трэка)

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

Число успешно считанных байт

-1 – Ошибка

Описание:

Функция считывает данные из набора данных связанного с fd и помещает эти данные в buf. В addr помещает адрес откуда была считанна запись (номер тцилиндра, номер трэка)

E_SEEK()

int E_SEEK(E_FILE *fd, long int offset, int origin, struct rec_addr *addr)

Параметры:

E_FILE *fd – указатель на дескриптор набора данных

long int offset – смещение

int origin – исходная позиция указателя на запись

SEEK_SET – начало набора данных

SEEK_CUR – текущая позиция указателя

SEEK_END – конец набора данных

strcut rec_addr *addr – указатель на структуру rec_addr, в которой содержится адрес записи (номер цилиндра, номер трэка) на которую был установлен указатель

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

0 – Успешное завершение

-1 – Выход за верхнюю границу

1 – Выход за нижнюю границу

Иначе – другая ошибка

Описание:

Данная функция смещает указатель набора данных связанный с fd, на offset записей вперёд или назад, относительно origin.

Дата добавления: 2015-11-14