Глобальные переменные и классы

Глобальные переменные

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.

Переменная	Назначение
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.

Мнемоника	Описание
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 Не то же устройство.

Мнемоника	Код ошибки 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.

Файл заголовка	Классы
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.

Флаг	Описание
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)

Обеспечивает базовый класс для чтения (извлечения) альтернативных объектов.

Функции-элементы

Класс 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.

Назад | Содержание | Вперед

Constructor	Создает подключенный conbuf.
clreol	Очищает экран до конца текстового окна.
clrscr	Очищает заданный экран.
delline	Удаляет строку в окне.
gotoxy	Позиционирует курсор в заданной позиции окна.
highvideo	Выделяет символы повышенной яркостью.
insline	Вставляет пустую строку.
lowvideo	Выделяет символы пониженной яркостью.
normvideo	Задает нормальную интенсивность символов.
overflow	Выводит содержимое conbuf.
setcursotype	Задает вид курсора.
textattr	Задает атрибут текста.
textbackground	Задает текстовый фоновый курсор.
textmode	Переводит курсор в текстовый режим.
wherex	Получает горизонтальную позицию курсора.
wherey	Получает вертикальную позицию курсора.
window	Определяет активное окно.

Constructor	Определяет для консоли неподсоединенный поток вывода.
clrscr	Очищает экран.
rdbuf	Возвращает указатель на назначенный для потока conbuf.
textmode	Переводит экран в текстовый режим.
window	Определяет активное окно.

constructor	Создает filebuf, не подключенный к файлу, или подключенный к файлу с заданным дескриптором.
attach	Связывает закрытый filebuf с файлом, заданным дескриптором. Если файловый буфер уже открыт, возвращает NULL.
close	Выводит содержимое буфера и закрывает файл. Обычно не требует явного вызова, т.к. закрытие обеспечивается деструктором. В случае ошибки возвращает 0.
fd	Возвращает дескриптор файла или EOF.
is_rtl_open	Возвращает в случае открытия файла ненулевое значение.
open	Открывает файл, заданный именем, и подключается к нему. Режим открытия задается аргументом режима.
overflow	Выводит буфер по указанному назначению. Выполняемые действия должны определяться в каждом классе.
seekoff	Устанавливает указатель по заданному смещению, перемещая его в заданном направлении относительно текущей позиции. Возвращает значение позиции.
setbuf	Выделяет буфер заданного размера для использования в качестве в filebuf. Если файл уже открыт, а буфер выделен, то происходит ошибка, и sefbuf возвращает NULL.
sync	Согласовывает внутренние структуры данных и внешнее представление потока.
underflow	Делает ввод доступным. Вызывается при отсутствии данных во входном буфере.

Constructor	Создает fstream, не подключенный или подключенный к файлу с заданным дескриптором.
open	Открывает для fstream файл, заданный именем и режимом открытия.
rdbuf	Возвращает используемый filebuf.

Constructor	Создает fstreambase, не подключенный или подключенный к файлу с заданным дескриптором.
attach	Связывает с дескриптором открытого файла.
open	Закрывает соответствующий filebuf и файл.
rdbuf	возвращает используемый filebuf.
setbuf	Резервирует указанную область памяти, способную вместить указанное число байт.

Constructor	Создает ifstrem, не подключенный к файла или подключенный к заданному или открытому файлу.
open	Открывает файл для ifstream.
rdbuf	Возвращает используемый filebuf.

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	Устанавливает все биты состояния.

Constructor	Связывает с потоком данный streambuf.
gcount	Возвращает число последний раз выделенных символов.
get	Получает следующий символ либо EOF, сохраняя их в буфере.
getline	То же, что и get, но ограничитель также считывается.
ignore	Пропускает n символов в потоке. При обнаружении delim останавливается.
ipfx	Вызывается функциями ввода перед выборкой из входного потока.
peek	Возвращает следующий символ без извлечения.
putback	Помещает символ обратно в поток.
read	Извлекает из потока и помещает в массив указанное число символов.
seekg	Перемещает заданное число байт относительно текущей позиции для потока ввода. Можно задавать направление.
tellg	Возвращает текущую позицию курсора. В случае неуспешного выполнения возвращает отрицательное число.
eatwrite	Извлекает последовательные пробелы.

Constructor	Создает osftream, не подключенный к файлу или подключает его к предварительно открытому файлу.
open	Открывает файл для заданного ofstream.
rdbuf	Возвращает используемый filebuf.

Constructor	Связывает с потоком заданный streambuf.
flush	Сбрасывает поток.
opfx	Вызывается функциями вывода перед включением в поток вывода. Возвращает 0, если ostream имеет ненулевое состояния ошибки.
osfx	Выполняет операции, необходимые после операций вывода.
put	Вставляет символ.
seekp	Перемещает в абсолютную позицию или позицию относительно текущей позиции.
tellp	Возвращает текущую позицию потока.
write	Вставляет указанное число символов (включая нули.

Constructor	Создает динамический ostrstream с буфером заданного размера.
pcount	Возвращает число байт, сохраненный в данный момент в буфере.
str	Возвращает и деактивизирует буфер. Если он был динамическим, вы должны отменить его.

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 в случае отсутствия буферизации.

Constructor	Создает strstreambase (пустой или с заданным буфером и начальным значением).
rdbuf	Возвращает указатель на связанный с данным объектом strstreambuf.

Constructor	Создает динамический strstreambuf. Память будет распределяться при необходимости или создает динамический буфер с заданными функциями выделения и освобождения.
deallocate	Выполняет выделение буфера на нижнем уровне.
freeze	Если параметр ввода ненулевой, то запрещает запись символов в буфер. Передача нулевого значения вновь активизирует буфер.
overflow	Выводит буфер по указанному назначению. Выполняемое действие должно определяться в каждом производном классе.
seekoff	Перемещает указатель относительно текущей позиции.
setbuf	Задает используемый буфер.
str	Возвращает указатель на буфер и активизирует его.
sync	Устанавливает соответствие между внутренними структурами данных и внешним представлением потоков.
underflow	Делает буфер ввода доступным. Вызывается, когда запрашивается символ, а strstreambuf пуст. Выполняемые действия должны определяться в производном классе.

Constructor	Создает динамический strstream.
str	Возвращает и деактивизирует буфер. Если он был динамическим, то пользователь должен освободить его.

attach	Если это возможно, связывает файл с заданным дескриптором с данными потоком.
close	Закрывает поток и соответствующий файл.
open	Открывает файл с указанным именем с заданными режимом и защитой. Открытый файл подключается к данному потоку.
rdbuf	Возвращает указатель на текущий файловый буфер.
setbuf	Выделяет буфер указанного размера.

Constructor	Создает буферизованный объект ifstream. Вы можете задать размер и начальное содержимое буфера, а также открыть файл и подключить его к потоку, задав имя, режиме и защиту или дескриптор файла.
open	Открывает указанный файл с заданным режимом и защитой. По умолчанию задается режим in (ввод) и защита openprot. Открытый файл связывается с потоком.
rdbuf	Возвращает указатель на текущий файловый буфер.

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. Тип данный определяет подразумеваемую форму записи.

bp	Указатель на буфер потока.
state	Флаги состояния формата.