Глобальные переменные
Borland С++ предусматривает ряд предопределенных глобальных
переменных, которые могут использоваться при работе с датой, временем, аргументами командной строки и т.д.
Переменная _8087 (dos.h)
Флаг микропроцессора (для DOS, Win16, Win32). Устанавливается в ненулевое значение, если логика автообнаружение кода запуска
обнаруживает наличие сопроцессора. Эту логику можно переопределить установкой переменной операционной среды 87.
Переменная _argc (dos.h)
Содержит число аргументов командной строки (для DOS, Win16,
Win32 и OS/2) - значение argc, переданное main при запуске программы.
Переменная _argv (dos.h)
Массив указателей на аргументы командной строки (для DOS,
Win16, Win32 и OS/2). Элементы этого массива передаются программе
при ее запуске.
Переменная _ctype (ctype.h)
Информационных массив символьных атрибутов (для DOS, Win16,
Win32 и OS/2), индексируемых значением ASCII +1. Каждая запись это битовый набор, описывающий символ.
Переменная _daylight (time.h)
Указывает, требуется ли сохранение настраиваемого времени
суток (для DOS, Win16, Win32 или OS/2). Используется функциями
даты и времени. Принимает значения 1 (сохраненное время) и 0
(стандартное).
Переменная _directvideo (cohio.h)
Флаг, управляющий видеовыводом (для DOS, Win16, Win32). Определяет вывод непосредственно в видеопамять (1) или через вызовы
BIOS в ПЗУ (0). По умолчанию равна 1. Эту переменную следует использовать только в символьных приложениях.
Переменная _environ (dos.h)
Позволяет обращаться к системным переменным операционной
среды и представляет собой массив указателей на строки "переменная=значение" (для DOS, Win16, Win32 и OS/2). Значение в строке
может быть пустым. При выполнении значения переменных среды передаются непосредственно программе.
Обращаться к _environ можно через getenv, а добавлять, изменять или удалять записи массива _environ - с помощью getenv.
Переменные errno, _doserrno, _sys_errlist, _sys_nerr (dos.h, errno.h)
Для печати сообщений об ошибке разрешает perror (для DOS,
Win16, Win32 и OS/2). Функция perror использует эти переменные
для вывода сообщений об ошибках.
| Переменная | Назначение
|
|---|
|
errno | Указывает тип ошибки при математическом
или системном вызове. В других ситуациях
не содержит кода ошибки.
|
|
_doserrno | Содержит фактический код ошибки операционной системы, когда вызов операционной системы дает ошибку.
|
|
_sys_errlist | Массив строк сообщений. В качестве индекса
массива для поиска строки по номеру ошибки
можно использовать errno.
|
|
_sys_nerr | Число строковых сообщений в _sys_nerr.
|
Мнемонические обозначения в _sys_errlist показаны в следующей таблице:
| Мнемоника | Описание
|
|---|
| E2BIG | Слишком длинный список аргументов.
|
| EACCES | В разрешении отказано.
|
| EBADF | Неверный номер файла.
|
| ECHILD | Нет дочернего процесса (Ч).
|
| ECONTR | Попытка удаления текущего каталога CurDir.
|
| EDEADLOCK | Нарушение блокировки (Ч).
|
| EDOM | Ошибка домена (*) или математического аргумента (Ч).
|
| EEXIST | Файл уже существует.
|
| EFAULT | Неизвестная ошибка.
|
| EINTR | Прерванный функциональный вызов (Ч).
|
| EINVACC | Недопустимый код доступа.
|
| EINVAL | Недопустимый аргумент.
|
| EINVDAT | Недопустимые данные.
|
| EINDRV | Недопустимая спецификация диска.
|
| EINVENV | Недопустимая операционная среда.
|
| EINVFMP | Недопустимый формат.
|
| EINVFNC | Недопустимый номер функции.
|
| EINVMEM | Недопустимый адрес блока памяти.
|
| EIO | Ошибка ввода-вывода (Ч).
|
| EMFILE | Открыто слишком много файлов.
|
| EMATOOLONG | Слишком длинное имя файла (Ч).
|
| ENFILE | Слишком много открытых файлов.
|
| ENMFILE | Файлов больше нет.
|
| ENODEV | Нет такого устройства.
|
| ENOENT | Нет такого файла или каталога.
|
| ENOEXEC | Ошибка формата выполняемого файла.
|
| ENOMEM | Не хватает памяти.
|
| ENOPATH | Маршрут не найден.
|
| ENOSPC | На устройстве не осталось места (Ч).
|
| ENOTSAM | Не то же устройство.
|
| ENXIO | Нет такого устройства или адреса (Ч).
|
| EPERM | Операция не разрешена (Ч).
|
| EPIPE | Нарушение конвейера (Ч).
|
| ERANGE | Результат вне диапазона (*) или слишком велик (Ч).
|
| EORFS | Файловая система доступна только по чтению (Ч).
|
| ESPIPE | Неразрешенная операция установки позиции (Ч).
|
| EXDEV | Перекрестная связь между устройствами.
|
| EZER0 | Ошибка 0.
|
(Ч) - только для 32-разрядных приложений.
(*) - только для 16-разрядных приложений.
Ниже перечислены мнемоники фактических кодов ошибок DOS, в
которые может устанавливаться _doserrno (это значение может не
отображаться через errno):
| Мнемоника | Код ошибки DOS
|
|---|
| E2BIG | Неверная операционная среда.
|
| EACCES | Доступ запрещен.
|
| EACCES | Неверный доступ.
|
| EACCES | Это текущий каталог.
|
| EBADF | Неверный описатель.
|
| EFAULT | Зарезервирован.
|
| EINVAL | Неверные данные.
|
| EINVAL | Неверная функция.
|
| EMFILE | Слишком много открытых файлов.
|
| ENOENT | Такого файла или каталога нет.
|
| ENOEXEC | Неверный формат.
|
| ENOMEM | Нет памяти.
|
| ENOMEM | Плохой блок.
|
| EXDEV | Неверный диск.
|
| EXDEV | Не то же устройство.
|
Переменная _floatconvert (stdio.h)
Компонует форматы с плавающей точкой (для DOS, Win16, Win32
и OS/2). Вывод с плавающей точкой требует компоновки подпрограмм
преобразования. Для уменьшения размера такая компоновка автоматически не выполняется. Однако, она выполняется автоматически при
использовании в программе математической подпрограммы или получении числа с плавающей точкой.
Переменная _fmode (fcntl.h)
Определяет заданный по умолчанию режим трансляции - текстовый или двоичный (для DOS, Win16, Win32 и OS/2). По умолчанию задается текстовый режим: при вводе возврат каретки/перевод строки
транслируется в перевод строки, а при выводе наоборот.
Переменная _new_handler
Перехватывает операции распределения (для DOS, Win16, Win32
и OS/2). Содержит указатель на функцию без аргументов, возвращающую void. При невозможности распределения памяти будет вызываться
функция, на которую указывает данная переменная. В качестве альтернативы можно использовать функцию _set_new_handler.
Переменные _osmajor, _osminor_, _osversion (dos.h)
Содержит основной и дополнительный номера версии операционной системы (для DOS, Win16, Win32 и OS/2).
Переменная _psp (dos.h)
Содержит адрес сегмента PSP для текущей программы (для DOS,
Win16, Win32 и OS/2). PSP - это дескриптор процесса DOS, который
содержит начальную информацию о программе.
Переменная _threadid (stddef.h)
Указатель на идентификатор нити (для DOS, Win32 и OS/2).
Это значение длинного целого типа, идентифицирующее текущую выполняемую нить.
Переменные __throwExceptionName, __throwFileName, __throwLineNumber (except.h)
Генерируют информацию о порожденной исключительной ситуации
(для DOS, Win16, Win32 и OS/2). Эти глобальные переменные позволяют получить имя и место возникновения особой ситуации (в виде
текстовой строки).
Переменная _timezone (time.h)
Содержит разницу в секундах между местным временем и временем по Гринвичу (для DOS, Win16, Win32 и OS/2). Используется
функциями даты и времени.
Переменная _tzname (time.h)
Массив указателей на имена временных поясов (для DOS, Win16,
Win32 и OS/2).
Переменная _version (dos.h)
Содержит номер версии операционной системы (для DOS, Win16,
Win32 и OS/2). Основной номер версии находится в старшем байте
(или слове для 32-разрядного приложения).
Переменная _wscroll (conio.h)
Разрешает или запрещает прокрутку в консольных функциях ввода-вывода (для DOS, Win16, Win32 и OS/2). По умолчанию прокрутка
разрешена - переменная имеет значение 1. При установке в 0 прокрутка запрещается. Данную переменную следует использовать только
в текстовых приложениях.
Потоковые классы С++
Библиотека потоковых классов в С++ состоит из нескольких
классов, распределенным по двум отдельным иерархическим деревьям.
Данный справочный материал содержит некоторые наиболее полезные
детали таких классов. Перечисляемые классы содержатся в различных
файлах заголовков:
| Файл заголовка | Классы
|
|---|
|
constrea.h | conbuf, constream (только для приложений консольного режима).
|
|
iostream.h | ios, iostream, iostream_withassign, istream,
istream_withassign, streambuf
|
|
fstream.h | filebuf, fstream, ostream, strstream, strstre-
ambase, strstreambuf.
|
Класс conbuf (constrea.h)
Специализирует streambuf для обработки консольного вывода.
Функции-элементы
| Constructor | Создает подключенный conbuf.
|
| clreol | Очищает экран до конца текстового окна.
|
| clrscr | Очищает заданный экран.
|
| delline | Удаляет строку в окне.
|
| gotoxy | Позиционирует курсор в заданной позиции окна.
|
| highvideo | Выделяет символы повышенной яркостью.
|
| insline | Вставляет пустую строку.
|
| lowvideo | Выделяет символы пониженной яркостью.
|
| normvideo | Задает нормальную интенсивность символов.
|
| overflow | Выводит содержимое conbuf.
|
| setcursotype | Задает вид курсора.
|
| textattr | Задает атрибут текста.
|
| textbackground | Задает текстовый фоновый курсор.
|
| textmode | Переводит курсор в текстовый режим.
|
| wherex | Получает горизонтальную позицию курсора.
|
| wherey | Получает вертикальную позицию курсора.
|
| window | Определяет активное окно.
|
Класс constream (constrea.h)
Обеспечивает потоки вывода на консоль. Этот класс является
производным от ostream и доступен только для приложений консольного режима.
Функции-элементы
| Constructor | Определяет для консоли неподсоединенный поток
вывода.
|
| clrscr | Очищает экран.
|
| rdbuf | Возвращает указатель на назначенный для потока conbuf.
|
| textmode | Переводит экран в текстовый режим.
|
| window | Определяет активное окно.
|
Класс filebuf (fstream.h)
Специализирует streambuf для ввода и вывода символов. Управляет выделением и удалением буфера, а также установкой позиции в
файле. Позволяет с помощью соответствующего конструктора или
функции-элемента использовать небуферизованный ввод-вывод. По
умолчанию файлы открываются в режиме openprot и допускают чтение
или запись. Этот класс обеспечивает только базовые средства для
ввода-вывода. Операции ввода-вывода выполняются с помощью функций
streambuf.
Элементы данных
| openprot | Заданная по умолчанию защита файла. Определяет разрешение чтения из файла и записи в файл.
|
Функции-элементы
| constructor | Создает filebuf, не подключенный к файлу, или
подключенный к файлу с заданным дескриптором.
|
| attach | Связывает закрытый filebuf с файлом, заданным
дескриптором. Если файловый буфер уже открыт,
возвращает NULL.
|
| close | Выводит содержимое буфера и закрывает файл.
Обычно не требует явного вызова, т.к. закрытие обеспечивается деструктором. В случае
ошибки возвращает 0.
|
| fd | Возвращает дескриптор файла или EOF.
|
| is_rtl_open | Возвращает в случае открытия файла ненулевое
значение.
|
| open | Открывает файл, заданный именем, и подключается к нему. Режим открытия задается аргументом режима.
|
| overflow | Выводит буфер по указанному назначению. Выполняемые действия должны определяться в каждом классе.
|
| seekoff | Устанавливает указатель по заданному смещению, перемещая его в заданном направлении относительно текущей позиции. Возвращает значение позиции.
|
| setbuf | Выделяет буфер заданного размера для использования в качестве в filebuf. Если файл уже открыт, а буфер выделен, то происходит ошибка, и sefbuf возвращает NULL.
|
| sync | Согласовывает внутренние структуры данных и
внешнее представление потока.
|
| underflow | Делает ввод доступным. Вызывается при отсутствии данных во входном буфере.
|
Класс fstream (fstream.h)
Этот потоковый класс является производным от fstreambase и
iostream и выполняет с помощью filebuf одновременный ввод и вывод.
Функции-элементы
| Constructor | Создает fstream, не подключенный или подключенный к файлу с заданным дескриптором.
|
| open | Открывает для fstream файл, заданный именем
и режимом открытия.
|
| rdbuf | Возвращает используемый filebuf.
|
Класс fstreamable (fstream.h)
Этот производный от ios класс обеспечивает общие для файловых потоков операции. Он используется в качестве базового для
fstream, ifstream и ofstream.
Функции-элементы
| Constructor | Создает fstreambase, не подключенный или подключенный к файлу с заданным дескриптором.
|
| attach | Связывает с дескриптором открытого файла.
|
| open | Закрывает соответствующий filebuf и файл.
|
| rdbuf | возвращает используемый filebuf.
|
| setbuf | Резервирует указанную область памяти, способную вместить указанное число байт.
|
Класс ifstream (fstream.h)
Этот производный от fsreambase потоковый класс обеспечивает
операции ввода через filebuf.
Функции-элементы
| Constructor | Создает ifstrem, не подключенный к файла или
подключенный к заданному или открытому файлу.
|
| open | Открывает файл для ifstream.
|
| rdbuf | Возвращает используемый filebuf.
|
Класс ios (iostream.h)
Обеспечивает общие операции для ввода и вывода. Производные
от него классы (istream, ostream, iostream) специализируют
ввод-вывод с помощью операций форматирования высокого уровня.
Класс ios является базовым для istream, ostream, fstreambase и
strstreambase.
Флаги формата
| Флаг | Описание
|
|---|
| skipws | Пропускает при вводе пробелы и разделители.
| | left | Выравнивание вывода влево.
| | right | Выравнивание вывода влево.
| | internal | Дополнение после знака или указателя основания.
| | dec | Десятичное преобразование.
| | oct | Восьмеричное преобразование.
| | hex | Шестнадцатиричное преобразование.
| | showbase | Показывает в выводе индикатор основания.
| | showpoint | Показывает при выводе с плавающей точкой десятичную точку.
| | uppercase | Преобразует шестнадцатиричный вывод в верхний
регистр.
| | showpos | Выводит с положительными числами символ '+'.
| | scientific | Добавляет к числам с плавающей точкой суффикс
с показателем степени (E).
| | fixed | Для вывода чисел с плавающей точкой использует десятичную фиксированную точку.
| | unitbuf | После включения выводит все потоки.
| | stdio | После включения выводит stdout и stderr.
|
Элементы данных
| adjustfield | Эти константы используются в качестве второго
| | basefield | параметра функции self. Они задают выравнива floatfield ние, систему счисления и формат числа.
| | seek_dir | Направление установки в потоке.
| | open_mode | Режим потоковой операции.
| | *pb | Соответствующий streambuf.
| | x_fill | Символ заполнения для вывода.
| | x_flags | Битовые флаги форматирования.
| | x_precision | Точность выводимых чисел с плавающей точкой.
| | state | Текущее состояние streambuf.
| | *x_tie | Связанный ostream (если он существует).
| | x_width | Ширина поля при выводе.
|
Функции-элементы
| Constructor | Связывает данный streambuf с потоком или
строит объект ios без соответствующего streambuf.
| | bad | Не 0 в случае ошибки.
| | bitalloc | Получает новый флаг битового набора. Возвращаемое значение может использовать для установки, очистки и проверки флаги. Это флаги
форматирования, определяемые пользователем.
| | eof | В конце файла возвращает ненулевое значение.
| | fail | Не 0 при неуспешном выполнении операции.
| | fill | Возвращает текущий символ-заполнитель или
сбрасывает его, возвращает предыдущий символ.
| | flags | Сбрасывает текущие флаги форматирования.
| | good | Не 0, если биты состояния не установлены (то
есть нет ошибок).
| | presicion | Возвращает текущую точность числа с плавающей
точкой.
| | rdbuf | Возвращает указатель на streambuf, назначенный для данного потока.
| | rdstate | Устанавливает флаги в соответствии с заданным
значением.
| | setf | Возвращает ранее установленные флаги.
| | sync_with_stdio | Смешивает файлы stdio и потоки iostreams. В
новой программе этого использовать не следует.
| | tie | Возвращает связанный поток или NULL, если такого потока не существует, или связывает с выходным потоком другой поток.
| | unseft | Очищает биты, соответствующие f, и возвращает
значение, представляющее собой предыдущие установки.
| | with | Возвращает или устанавливает текущую ширину.
| | xalloc | Возвращает индекс в массиве ранее не используемых слов, которые можно применять как флаги форматирования.
| | init | Выполняет фактическую инициализацию.
| | selstate | Устанавливает все биты состояния.
|
Класс iostream (iostream.h)
Данный производный от istream и ostream класс представляет
собой смесь своих базовых классов для ввода и вывода в поток. Он
является базовым для fstream и strstream.
Функции-элементы
| Constructor | Связывает с потоком заданный streambuf.
|
Класс iostream_withassign (iostream.h)
Этот класс представляет собой iostream c добавленными оператором присваивания.
Функции-элементы
| Constructor | Заданный по умолчанию конструктор (вызывает
конструктор iostream).
|
Класс istream (iostream.h)
Обеспечивает форматированный и неформатированный ввод из
streambuf. Для фундаментальных типов операция >> переопределяется. Базовым для данного класса является класс ios.
Функции-элементы
| Constructor | Связывает с потоком данный streambuf.
| | gcount | Возвращает число последний раз выделенных
символов.
| | get | Получает следующий символ либо EOF, сохраняя
их в буфере.
| | getline | То же, что и get, но ограничитель также считывается.
| | ignore | Пропускает n символов в потоке. При обнаружении delim останавливается.
| | ipfx | Вызывается функциями ввода перед выборкой из
входного потока.
| | peek | Возвращает следующий символ без извлечения.
| | putback | Помещает символ обратно в поток.
| | read | Извлекает из потока и помещает в массив указанное число символов.
| | seekg | Перемещает заданное число байт относительно
текущей позиции для потока ввода. Можно задавать направление.
| | tellg | Возвращает текущую позицию курсора. В случае
неуспешного выполнения возвращает отрицательное число.
| | eatwrite | Извлекает последовательные пробелы.
|
Класс istream_withassign (iostream.h)
Этот класс представляет собой istream с добавленной операцией присваивания.
Функции-элементы
| Constructor | Используемый по умолчанию конструктор (вызывает конструктор istream).
|
Класс istream (strstrea.h)
Обеспечивает для strstreambuf операции ввода. Этот класс является производным от strstreambase и istream.
Функции-элементы
| Constructor | Создает istream с заданной строкой (нулевой
символ не извлекается).
|
Класс ofstream (fstream.h)
Является производным от fstreamable и ostream и обеспечивает
для filebuf операции ввода.
Функции-элементы
| Constructor | Создает osftream, не подключенный к файлу или подключает его к предварительно открытому файлу.
| | open | Открывает файл для заданного ofstream.
| | rdbuf | Возвращает используемый filebuf.
|
Класс ostream (iostream.h)
Обеспечивает для streambuf форматированный или неформатированный вывод. Для всех фундаментальных типов операция << переопределяется. Этот производный от ios класс является базовым для
constream, iostream, ofstream, ostrstream и ostream_withassing.
Функции-элементы
|
Constructor | Связывает с потоком заданный streambuf.
| | flush | Сбрасывает поток.
| | opfx | Вызывается функциями вывода перед включением
в поток вывода. Возвращает 0, если ostream
имеет ненулевое состояния ошибки.
| | osfx | Выполняет операции, необходимые после операций вывода.
| | put | Вставляет символ.
| | seekp | Перемещает в абсолютную позицию или позицию
относительно текущей позиции.
| | tellp | Возвращает текущую позицию потока.
| | write | Вставляет указанное число символов (включая
нули.
|
Класс ostream_withassign (iostream.h)
Этот класс представляет собой ostream с добавленной операцией присваивания.
Функции-элементы
Constructor Используемый по умолчанию конструктор (вызывает конструктор ostream).
|
Класс oststream (strstrea.h)
Является производным от strstreambase и ostream и обеспечивает для strstreambuf операции вывода.
Функции-элементы
| Constructor | Создает динамический ostrstream с буфером заданного размера.
| | pcount | Возвращает число байт, сохраненный в данный
момент в буфере.
| | str | Возвращает и деактивизирует буфер. Если он
был динамическим, вы должны отменить его.
|
Класс streambuf (iostream.h)
Это базовый класс для всех других классов буферизации. Он
обеспечивает буферный интерфейс между вашими данными и областями
памяти, такими как память физических устройств. К содержимому
этих областей можно обращаться по указателю.
Функции-элементы
| Constructor | Создает пустой объект буфера.
| | in_avail | Возвращает число символов, оставшихся в буфере ввода.
| | out_waiting | Возвращает число символов, оставшихся в буфере вывода.
| | sbumpc | Возвращает число символов в текущем буфере
ввода, а затем продвигает позицию.
| | seekpos | Перемещает указатель на абсолютную позицию.
| | sgetc | Устанавливается на следующий символ в буфере
ввода.
| | snextc | Продвигает позицию и возвращает следующий
символ в буфере ввода.
| | sputbackc | Возвращает символ в поток ввода.
| | sputc | Помещает в буфер вывода один символ.
| | sputn | Помещает в буфер вывода n символов.
| | stossc | Продвигает позицию до следующего символа в
буфере ввода.
| | allocate | Задает область вывода.
| | base | Возвращает начало буфера вывода.
| | blen | Возвращает длину буфера вывода.
| | eback | Возвращает начало секции обратного занесения
в области получения.
| | ebuf | Возвращает из области буфера end+1.
| | epptr | Возвращает из области get или put end+1.
| | gbump | Продвигает указатель get.
| | gptr | Возвращает следующую ячейку в области get.
| | pbase | Возвращает начало области put.
| | pbump | Продвигает указатель put.
| | pptr | Возвращает следующую ячейку в области put.
| | setb | Устанавливает область буфера.
| | setg | Инициализирует указатели get.
| | setp | Инициализирует указатель put.
| | unbuffered | Устанавливает состояние буферизации или возвращает не 0 в случае отсутствия буферизации.
|
Класс strstreambase (strstrea.h)
Специализирует ios для строковых потоков. За исключением
функции-элемента strstreambase::rdbuf, весь класс является защищенными. Этот класс является базовым для strstream, istrstream и
ostrstream.
Функции-элементы
| Constructor | Создает strstreambase (пустой или с заданным
буфером и начальным значением).
| | rdbuf | Возвращает указатель на связанный с данным
объектом strstreambuf.
|
Класс strstreambuf (strstrea.h)
Специализирует streambuf для форматирования в памяти.
Функции-элементы
| Constructor | Создает динамический strstreambuf. Память будет распределяться при необходимости или создает динамический буфер с заданными функциями
выделения и освобождения.
| | deallocate | Выполняет выделение буфера на нижнем уровне.
| | freeze | Если параметр ввода ненулевой, то запрещает
запись символов в буфер. Передача нулевого значения вновь активизирует буфер.
| | overflow | Выводит буфер по указанному назначению. Выполняемое действие должно определяться в каждом производном классе.
| | seekoff | Перемещает указатель относительно текущей позиции.
| | setbuf | Задает используемый буфер.
| | str | Возвращает указатель на буфер и активизирует
его.
| | sync | Устанавливает соответствие между внутренними
структурами данных и внешним представлением
потоков.
| | underflow | Делает буфер ввода доступным. Вызывается,
когда запрашивается символ, а strstreambuf
пуст. Выполняемые действия должны определяться в производном классе.
|
Класс strstream (strstrea.h)
Обеспечивает для strstreambuf одновременный ввод и вывод.
Этот класс является производным от strstreambase и iostream.
Функции-элементы
| Constructor | Создает динамический strstream.
| | str | Возвращает и деактивизирует буфер. Если он
был динамическим, то пользователь должен освободить его.
|
Постоянные потоковые классы и макрокоманды
Borland поддерживает постоянные потоки, состоящие из иерархии класса и макрокоманд, помогающих вам строить потоковые объекты.
Иерархия классов постоянных потоков
Иерархия классов постоянных потоков представляется следующей
схемой:
pstream
^ ^ ^
TStreamable
^ ^
ipstream opstream fpbase
^ ^ ^ ^
ofpstream
ifstream
Двойная стрелка указывает, что TStreamableBase - это дружественный класс.
Класс fpbase (objstm.h)
Обеспечивает базовые операции, общие для всех потоков ввода-вывода объектного файла.
Функции-элементы
| attach | Если это возможно, связывает файл с заданным
дескриптором с данными потоком.
| | close | Закрывает поток и соответствующий файл.
| | open | Открывает файл с указанным именем с заданными
режимом и защитой. Открытый файл подключается
к данному потоку.
| | rdbuf | Возвращает указатель на текущий файловый буфер.
| | setbuf | Выделяет буфер указанного размера.
|
Класс ifpstream (objstrm.h)
Обеспечивает базовый класс для чтения (извлечения) потоковых
объектов из потоков.
Функции-элементы
| Constructor | Создает буферизованный объект ifstream. Вы
можете задать размер и начальное содержимое буфера, а также открыть файл и подключить его к потоку, задав имя, режиме и защиту или дескриптор файла.
| | open | Открывает указанный файл с заданным режимом и
защитой. По умолчанию задается режим in
(ввод) и защита openprot. Открытый файл связывается с потоком.
| | rdbuf | Возвращает указатель на текущий файловый буфер.
|
Класс ipstream (objstrm.h)
Обеспечивает базовый класс для чтения (извлечения) альтернативных объектов.
Функции-элементы
| Constructor | Создает буферизованный ipstream c заданным
буфером и устанавливает элемент данных bp.
Защищенная форма конструктора не инициализирует указатель буфера.
| | find | Возвращает указатель на объект, соответствующий заданному идентификатору.
| | freadBytes | Считывает в указанный буфер заданное число
байт.
| | freadString | Считывает строку из буфера. Определяет длину
строки и выделяет соответствующий символьный
массив far. Считывает массив в строку и возвращает указатель на массив. Освободить выделенный блок памяти должна вызывающая сторона.
| | getVersion | Возвращает номер версии объекта.
| | readByte | Возвращает символ в текущей позиции курсора.
| | readBytes | Считывает заданное число байт из текущей позиции потока и записывает их в заданный массив.
| | readString | Выделяет буфер для записи строки в текущей
позиции курсора. Считывает строку из потока в
буфер. Либо считывает строку в заданный аргументом буфер.
| | readWord | Возвращает 32-битовое слово в текущей позиции
в потоке.
| | readWord16 | Возвращает 16-битовое слово в текущей позиции
потока.
| | registerObject | Возвращает объект, на который указывает аргумент.
| | seekg | Перемещает позицию потока в абсолютную позицию, заданную аргументом или перемещает позицию относительно текущей позиции на указанное
смещение (в прямом или обратном направлении).
| | tellg | Возвращает текущую позицию в потоке (абсолютную).
| | readData | Вызывает для чтения из потока соответствующую
функцию read и помещает ее в заданный объект. Если объекта не существует, то сначала вызывается функция build.
| | readPrefix | Возвращает объект TStreamableClass, соответствующий заданному классу, записанному в текущей позиции.
| | readSuffix | Считывает и проверяет конечный байт поля имени объекта.
| | readVersion | Устанавливает для потока ввода номер версии.
| | Operator >> | Извлекает (считывает) данные из заданного потока ipstream и помещает его в указанный аргумент. Возвращается ссылка на поток, что
позволяет обычным образом использовать цепочку операций.
| | flush | Сбрасывает поток.
| | fwriteBytes | Записывает заданное число байт из указанного
буфера в поток.
| | registerObject | Регистрирует класс объекта, указываемого аргументом.
| | registerVB | Регистрирует виртуальный базовый класс.
| | seekp | Перемещает текущую позицию потока в заданную
абсолютную позицию или в позицию, заданную смещением.
| | tellp | Возвращает абсолютную текущую позицию потока.
| | writeByte | Записывает заданный байт в поток.
| | writeBytes | Записывает указанное число байт из буфера в
поток.
| | writeObject | Записывает объект, на который указывает аргумент, в поток вывода.
| | writeObjectPtr | Записывает заданный указатель объекта в поток
вывода.
| | writeString | Записывает в поток заданную строку (с предшествующим байтом длины).
| | writeWord | Записывает в поток указанное 32-битовое слово.
| | writeWord16 | Записывает в поток указанное 16-битовое слово.
| | writeWord32 | Записывает в поток указанное 32-битовое слово.
| | writeData | Записывает данные в поток путем вызова для
записываемого объекта соответствующей функции-элемента write.
| | writePrefix | Записывает в поток класс с указанным префиксом имени. Операция << использует эту
функцию для записи с помощью writeData префикса и суффикса, который используется для
обеспечения надежного потокового ввода-вывода.
| | writeSuffix | Записывает в поток класс с указанным суффиксом имени. Операция << использует эту функцию для записи с помощью writeData префикса и
суффикса, который используется для обеспечения надежного потокового ввода-вывода.
| | operator << | Включает (записывает) заданный аргумент в
указанный объект ipstream. Тип данный определяет подразумеваемую форму записи.
|
Класс pstream (objstrm.h)
Это базовый класс для управления потоковыми объектами.
Элементы данных
| bp | Указатель на буфер потока.
| | state | Флаги состояния формата.
|
Функции-элементы
| Constructor | Создает буферизованный pstream с заданным буфером и устанавливает элемент данных в bp. Состояние устанавливается в 0.
| | Destructor | Уничтожает объект pstream.
| | bad | В случае ошибки возвращает не 0.
| | clear | Устанавливает состояние потока в заданное
значение (по умолчанию 0).
| | eof | В конце потока возвращает не 0.
| | fail | В случае неудачного завершения потоковой операции возвращает ненулевое значение.
| | good | Возвращает не 0, если биты состояния не установлены (то есть нет ошибок).
| | rdbuf | Возвращает указатель pb на назначенный потоку
буфер.
| | rdstate | Возвращает текущее значение состояния.
| | operator void *() | Переопределяет операцию приведения типа (указателя на void). При неуспешном выполнении возвращает 0.
| | operator !() | Переопределяет операцию NOT. Возвращает значение, переданное pstream::fail.
| | init | Инициализирует поток: устанавливает состояние
в 0, а bp - в переданный аргумент sbp.
| | setstate | Обновляет элемент данных state значением state |= (b & 0xFF).
|
Класс TStreamableBase (objstrn.h)
Классы, наследующие из TStreamableBase, называются потоковыми классами. Это означает, что их объекты могут записываться в
потоки и считываться из них. Для построения собственных потоковых
классов также нужно использовать этот базовый класс. Можно воспользоваться и множественным наследованием.
Функции-элементы
| Destructor | Уничтожает объект TStreamableBase().
| | CastableID | Обеспечивает поддержку надежного приведения
типов. Возвращает строку, содержащую имя типа.
| | FindBase | Возвращает указатель на базовый класс.
| | MostDerived | Возвращает указатель void на фактический потоковый объект.
|
Класс TStreamable (streambl.h)
Используется частным классом базы данных и pstream для регистрации в потоковом классе.
Функции-элементы
| Constructor | Создает объект TStreamableClass с заданным
именем и функцией построения, затем регистрирует тип. Каждый потоковый класс имеет функцию построения build типа BUILDER. Для обеспечения надежного по типу ввода и вывода объектов с использованием потоков администратору потоков требуется доступ к информации об именах и типах каждого класса.
|
Класс TStreamer (objstrm.h)
Базовый класс для всех потоковых объектов.
Функции-элементы
| Constructor | Строит объект TStreamer и инициализирует указатель потокового объекта.
| | GetObject | Возвращает адрес компонента TStreamable потокового объекта.
| | Read | "Чистая" виртуальная функция, которая должна переопределяться в каждом потоковом классе. Из переданного ipstream она должна считывать необходимые элементы данных для потокового класса.
| | StreaableName | "Чистая" виртуальная функция-элемент, которая
должна переопределяться для каждого потокового класса. Возвращает имя потокового класса
(строку с завершающим 0), которое используется администратором потока для регистрации
этого класса.
| | Write | "Чистая" виртуальная функция-элемент, которая
должна переопределяться для каждого потокового класса. Она должна записывать в заданный
объект opstream необходимые элементы данных потокового класса.
|
Макрокоманда __DELTA (streambl.h)
Вычисляет расстояние (в байтах) между базой потокового объекта и началом компонента TStreamableBase этого объекта.
Макрокоманды, начинающиеся с DECLARE
Макрокоманда DECLARE_STREABABLE (objstrm.h)
Используется в определении класса для добавления элементов, необходимых для организации потока. Так как она содержит спецификаторы доступа, за ней должен следовать спецификатор доступа (или он должен использоваться в конце определения класса). Первым параметром должна быть макрокоманда, расширяющаяся по условию в __import или __export (в зависимости от того, экспортируется или импортируется класс из DLL). Второй параметр - имя потокового
класса, а третий - номер версии объекта.
Макрокоманда DECLARE_STREAMABLE_FROM_BASE (objstrm.h)
Используется аналогично DECLARE_STREAMABLE. Ее не следует
использовать, если класс должен записываться и считываться с помощью функций Read и Write, определенных без изменения в своем
базовом классе. Обычно это происходит, если производный класс переопределяет виртуальные функции базового класса или предусматривает несколько конструкторов, но не добавляет элементов данных.
Макрокоманда DECLARE_ABSTRACT_STREAMABLE (objstrm.h)
Используется в абстрактном классе и содержит ядро потокового
кода. Описывает функции Read и Write, определения которых вы
должны предусмотреть, и функцию Buyild, вызывающую конструктор
TStreabableClass. Описания параметров см. в DECLARE_STREAMABLE.
Макрокоманда DECLARE_STREAMER_FROM_BASE (objstrm.h)
Используется в DECLARE_STREAMABLE_FROM_BASE и описывает вложенный класс Streamer без функций Read и Write. Описания параметров см. в DECLARE_STREAMABLE.
Макрокоманда DECLARE_ABSTRACT_STREAMER (objstrm.h)
Используется в DECLARE_ABSTRACT_STREAMABLE и описывает вложенный класс Streamer без функции Build. Описания параметров см.
в DECLARE_STREAMABLE.
Макрокоманда DECLARE_STREAMABLE_OPS (objstrm.h)
Описывает инсертеры и экстракторы. Для классов шаблонов
должна использовать в качестве макроаргумента class<...>. В других случаях используется только имя класса.
Макрокоманда DECLARE_STREAMABLE_CTOR (objstrm.h)
Описывает конструктор, вызываемый функцией Streamer::Build.
Макрокоманды, начинающиеся с IMPLEMENT
Макрокоманды IMPLEMENT_STREAMABLE1..4 (objstrm.h)
Макрокоманды IMPLEMENT_STREAMABLE генерируют для класса регистрационный объект через IMPLEMENT_STREAMABLE_CLASS и через
IMPLEMENT_ABSTRACT_STREABABLE генерируют различные необходимые
для потокового класса Функции-элементы.
Макрокоманда IMPLEMENT_STREAMABLE используются, когда класс
не имеет других базовых классов, кроме TStreamableBase. Ее единственным параметром является имя класса. Нумерованные версии этой
макрокоманды (IMPLEMENT_STREAMABLE1, IMPLEMENT_STREAMABLE2 и
т.д.) используются для классов, имеющих другие базовые классы.
Макрокоманда IMPLEMENT_STREAMABLE_CLASS (objstrm.h)
Строит экземпляр класса TStreamableClass.
Макрокоманды IMPLEMENT_STREAMABLE_CTOR1..4 (objstrm.h)
Определяют конструктор, вызываемый функцией Build. В соответствующей макрокоманде должны перечисляться все базовые классы.
Макрокоманда IMPLEMENT_POINTER (objstrm.h)
Создает экземпляр операции извлечения указателя (>>).
Макрокоманда IMPLEMENT_CASTABLE (objstrm.h)
Устанавливает надежный по типу идентификатор с приведенным
типом.
Макрокоманды IMPLEMENT_CASTABLE1..5 (objstrm.h)
Реализуют код, поддерживающий надежный по типу механизм приведения типа.
Макрокоманда IMPLEMENT_STREAMER (objstrm.h)
Определяет конструктор Streamer.
Макрокоманды IMPLEMENT_ABSTRACT_STREAMABLE1..5 (objstrm.h)
Макрокоманда IMPLEMENT_STREAMABLE_FROM_BASE (objstrm.h)
Эта макрокоманда расширяется в IMPLEMENT_STREAMABLE_CLASS
(которая строит TStreamableClass), IMPLEMENT_STREAMABLE_CTOR1 и
IMPLEMENT_STREAMABLE_POINTER.
Назад | Содержание | Вперед
|
|
Виртуальные VPS серверы в РФ и ЕС
🔥 VPS до 5.7 ГГц под любые задачи с AntiDDoS в 7 локациях
