Идёт загрузка страницы...

htp://aptem.net.ru
Навигатор
На форум
Софт
Программирование
Delphi
Visual Basic
Borland C++
1С
Вебмастеру
HTML
PHP
Perl
ОС
Windows XP
Windows 98
Windows 2000




 

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

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.

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