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

         

Open



     open

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

Синтаксис #include

#include

int open(const char *filename, int access [, unsigned mode]); Файл, содержащий io.h прототип

Описание Функция open открывает файл, имя которого опреде- лено параметром filename, и подготавливает его к последующим операциям чтения и/или записи, в за- висимости от параметра access.

Для создания файла в обычном режиме, вы можете присвоить соответствующее значение _fmode, или при открытии файла указать опции O_CREAT и O_TRUNC связанные операцией побитового логическо- го сложения (OR) с необходимым режимом передачи. К примеру:

open("xmp",O_CREAT|O_TRUNC|O_BINARY,S_IREAD);

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

Для функции open параметр access конструируется путем логического побитового сложения флагов, пе- речисленных в двух следующих списках. Из первого списка может быть использован только один флаг; остальные флаги могут применяться в любых логи- ческих комбинациях.

Список 1: флаги чтения/записи.

O_RDONLY открытие только для чтения. O_WRONLY открытие только для записи. O_RDWR открытие для чтения и записи.

Список 2: остальные флаги доступа.

O_NDELAY Не используется; для совместимости с системой UNIX. O_APPEND Если флажок установлен, то перед каждой операцией записи, указатель файла бу- дет устанавливаться на конец файла. O_CREAT Если файл существует, этот флажок не имеет никакого значения. Если файл не существует, он будет создан, и биты из аргумента mode будут использованы для установки битов-атрибутов файла, как и в функции chmod. O_TRUNC Если файл существует, его длина усека- ется до 0. Атрибуты файла остаются не- изменными. O_EXCL Используется только вместе с O_CREAT. Если файл уже существует, то происходит возврат по ошибке. O_BINARY Данный флаг может быть установлен для гарантированного открытия файла в двоичном режиме. O_TEXT Данный флаг может быть установлен для гарантированного открытия файла в текс- товом режиме.


Эти константы (O_...) определены в файле fcntl.h.

Если ни O_BINARY, ни O_TEXT не указаны, файл отк- рывается в режиме трансляции, соответственно гло- бальной переменной _fmode.

Если в построении параметра access участвует флаг O_CREAT, вам необходимо указать аргумент mode из следующих символических констант, определенных в файле sys\stat.h.

-------------------------------------------------- Значение параметра Возможности доступа mode -------------------------------------------------- S_IWRITE Разрешение на запись. S_IREAD Разрешение на чтение. S_IREAD/S_IWRITE Разрешение на чтение/запись. --------------------------------------------------

Возвращаемое При успешном завершении open возвращает целое значение неотрицательное число handle - логический номер открытого файла. Указатель файла (указатель теку- щей позиции) устанавливается на начало файла. При ошибке функция возвращает значение -1, и перемен- ная errno получает одно из следующих значений:



ENOENT - Маршрут или имя файла не найдены; EMFILE - Слишком много открытых файлов; EACCES - Доступ запрещен; EINVACC - Неверный код доступа.

Переносимость Функция open поддерживается на системах UNIX. На версии 7 системы UNIX мнемоника O_тип не опре- делена. Система UNIX SYSTEM 3 пользуется всеми мнемониками O_тип за исключением O_BINARY.

Смотрите также ,


Outport



     outport

Функция Производит вывод в порт.

Синтаксис void outport(int portid, int value);

Файл, содержащий dos.h прототип

Описание outport записывает значение параметра value в вы- ходной порт, определяемый параметром portid.

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

Переносимость Эта функция уникальна для DOS.



Outportb



     outportb

Функция Производит вывод в порт байта.

Синтаксис void outport(int portid, unsigned char value);

Файл, содержащий dos.h прототип

Описание outportb - это макрокоманда, которая записывает значение параметра value в выходной порт, опреде- ляемый параметром portid.

При вызове outportb при указанном включаемом фай- ле dos.h, то outportb рассматривается как макро, и расширяется во встроенный машинный код.

Если вы не включаете файл dos.h, или если вы от- менили outportb командой #undef, то получите фун- кцию outportb.

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

Переносимость Эта функция уникальна для DOS.

Смотрите также



Outtext



     outtext

Функция Отображает строку в окне экрана.

Синтаксис #include

void far outtext(char far *textstring);

Файл, содержащий graphics.h прототип

Описание outtext отображает строку текста в окне, используя текущие установленные параметры вырав- нивания текста, а также текущие шрифт, направле- ние и размер.

outtext выводит текст в текущую позицию. Если горизонтальное выравнивание текста равно LEFT_TEXT и направление вывода текста установле- но равным HORIZ_DIR, координата x текущей пози- ции продвигается с помощью textwidth(textstring).Иначе текущая позиция ос- тается неизменной.

Для обеспечения совместимости кодов поддержки при использовании различных шрифтов,используйте textwidth и textheight для определения размеров строки.

Замечание. Если строка печатается установленным по умолчанию шрифтом с помощью функции outtext, то любая часть строки , которая выходит за пре- делы текущего окна, отсекается.

Замечание. outtext предназначен для работы в графическом режиме и не будет работать в тексто- вом режиме.

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

Переносимость Эта функция пригодна только для компьюте- ров IBM PC и совместимых с ними, оснащенных дис- плейными адаптерами, поддерживающими графический режим.

Смотрите также



Outtextx



     outtextxy

Функция Отображает строку в указанной области.

Синтаксис #include

void far outtextxy(int x,int y, char far *textstring);

Файл, содержащий graphics.h прототип

Описание outtext отображает строку текста в окне экрана в заданной позиции (x,y), используя теку- щие установленные параметры выравнивания текста, а также текущие шрифт, направление и размер.

Для обеспечения совместимости кодов поддержки при использовании различных шрифтов,используйте textwidth и textheight для определения размеров строки.

Замечание. Если строка печатается установленным по умолчанию шрифтом с помощью функций outtext и outtextxy, то любая часть строки , которая выхо- дит за пределы текущего окна отсекается.

Замечание. outtext предназначен для работы в графическом режиме и не будет работать в тексто- вом режиме.

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

Переносимость Эта функция пригодна только для компьюте- ров IBM PC и совместимых с ними, оснащенных дис- плейными адаптерами, поддерживающими графический режим.

Смотрите также