Потоки

10.1 Введение

Широко известна трудность задачи проектирования и реализации стандартных средств ввода-вывода для языков программирования. Традиционно средства ввода-вывода были рассчитаны исключительно на небольшое число встроенных типов данных. Однако, в нетривиальных программах на С++ есть много пользовательских типов данных, поэтому необходимо предоставить возможность ввода-вывода значений таких типов. Очевидно, что средства ввода-вывода должны быть простыми, удобными, надежными в использовании и, что важнее всего, адекватными. Пока никто не нашел решения, которое удовлетворило бы всех; поэтому необходимо дать возможность пользователю создавать иные средства ввода-вывода, а также расширять стандартные средства ввода-вывода в расчете на определенное применение.

Цель создания С++ была в том, чтобы пользователь мог определить новые типы данных, работа с которыми была бы столь же удобна и эффективна как и со встроенными типами. Таким образом, кажется разумным потребовать, чтобы средства ввода-вывода для С++ программировались с использованием возможностей С++, доступных каждому. Представленные здесь потоковые средства ввода-вывода появились в результате попытки удовлетворить этим требованиям.

Основная задача потоковых средств ввода-вывода - это процесс преобразования объектов определенного типа в последовательность символов и наоборот. Существуют и другие схемы ввода-вывода, но указанная является основной, и если считать символ просто набором битов, игнорируя его естественную связь с алфавитом, то многие схемы двоичного ввода-вывода можно свести к ней. Поэтому программистская суть задачи сводится к описанию связи между объектом определенного типа и бестиповой (что существенно) строкой.

Последующие разделы описывают основные части потоковой библиотеки С++:

10.2 Вывод: То, что для прикладной программы представляется выводом, на самом деле является преобразованием таких объектов как int, char *, complex или Employee_record в последовательность символов. Описываются средства для записи объектов встроенных и пользовательских типов данных.

10.3 Ввод: Описаны функции для ввода символов, строк и значений встроенных и пользовательских типов данных.

10.4 Форматирование: Часто существуют определенные требования к виду вывода, например, int должно печататься десятичными цифрами, указатели в шестнадцатеричной записи, а вещественные числа должны быть с явно заданной точностью фиксированного размера. Обсуждаются функции форматирования и определенные программистские приемы их создания, в частности, манипуляторы.

10.5 Файлы и потоки: Каждая программа на С++ может использовать по умолчанию три потока - стандартный вывод (cout), стандартный ввод (cin) и стандартный поток ошибок (cerr). Чтобы работать с какими- либо устройствами или файлами надо создать потоки и привязать их к этим устройствам или файлам. Описывается механизм открытия и закрытия файлов и связывания файлов с потоками.

10.6 Ввод-вывод для С: обсуждается функция printf из файла <stdio.h> для С а также связь между библиотекой для С и <iostream.h> для С++.

Укажем, что существует много независимых реализаций потоковой библиотеки ввода-вывода и набор средств, описанных здесь, будет только подмножеством средств, имеющихся в вашей библиотеке. Говорят, что внутри любой большой программы есть маленькая программа, которая стремится вырваться наружу. В этой лекции предпринята попытка описать как раз маленькую потоковую библиотеку ввода-вывода, которая позволит оценить основные концепции потокового ввода-вывода и познакомить с наиболее полезными средствами. Используя только средства, описанные здесь, можно написать много программ; если возникнет необходимость в более сложных средствах, обратитесь за деталями к вашему руководству по С++. Заголовочный файл <iostream.h> определяет интерфейс потоковой библиотеки. В ранних версиях потоковой библиотеки использовался файл <stream.h>. Если существуют оба файла, <iostream.h> определяет полный набор средств, а <stream.h> определяет подмножество, которое совместимо с ранними, менее богатыми потоковыми библиотеками.

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

10.2 Вывод

Строгую типовую и единообразную работу как со встроенными, так и с пользовательскими типами можно обеспечить, если использовать единственное перегруженное имя функции для различных операций вывода.

Например:

put(cerr,"x = "); // cerr - выходной поток ошибок
put(cerr,x);
put(cerr,'\n');

Тип аргумента определяет какую функцию надо вызывать в каждом случае. Такой подход применяется в нескольких языках, однако, это слишком длинная запись. За счет перегрузки операции << , чтобы она означала "вывести" ("put to"), можно получить более простую запись и разрешить программисту выводить в одном операторе последовательность объектов, например так:

cerr << "x = " << x << '\n';

Здесь cerr обозначает стандартный поток ошибок. Так, если х типа int со значением 123, то приведенный оператор выдаст

x = 123

и еще символ конца строки в стандартный поток ошибок. Аналогично, если х имеет пользовательский тип complex со значением (1,2.4), то указанный оператор выдаст

x = (1,2.4)

в поток cerr. Такой подход легко использовать пока x такого типа, для которого определена операция <<, а пользователь может просто доопределить << для новых типов.

Мы использовали операцию вывода, чтобы избежать многословности, неизбежной, если применять функцию вывода. Но почему именно символ <<? Невозможно изобрести новую лексему (лекцию 7). Кандидатом для ввода и вывода была операция присваивания, но большинство людей предпочитает, чтобы операции ввода и вывода были различны. Более того, порядок выполнения операции = неподходящий, так cout=a=b означает cout=(a=b). Пробовали использовать операции < и >, но к ним так крепко привязано понятие "меньше чем" и "больше чем", что операции ввода-вывода с ними во всех практически случаях не поддавались прочтению.

Операции << и >> похоже не создают таких проблем. Они асиметричны, что позволяет приписывать им смысл "в" и "из". Они не относятся к числу наиболее часто используемых операций над встроенными типами, а приоритет << достаточно низкий, чтобы писать арифметические выражения в качестве операнда без скобок:

cout << "a*b+c=" << a*b+c << '\n';

Скобки нужны, если выражение содержит операции с более низким приоритетом:

cout << "a^b|c=" << (a^b|c) << '\n';

Операцию сдвига влево можно использовать в операции вывода, но, конечно, она должна быть в скобках:

cout << "a<<b=" << (a<<b) << '\n';

10.2.1 Вывод встроенных типов

Для управления выводом встроенных типов определяется класс ostream с операцией << (вывести):

class ostream : public virtual ios {
    // ...
public:
   ostream operator<<(const char*);    //строки
   ostream operator<<(char);
   ostream operator<<(short i)
     { return *this << int(i); }
   ostream operator<<(int);
   ostream operator<<(long);
   ostream operator<<(double);
   ostream operator<<(const void*);    // указатели
    // ...
             };

Естественно, в классе ostream должен быть набор функций operator<<() для работы с беззнаковыми типами.

Функция operator<< возвращает ссылку на класс ostream, из которого она вызывалась, чтобы к ней можно было применить еще раз operator<<. Так, если х типа int, то

cerr << "x = " << x;

понимается как

(cerr.operator<<("x = ")).operator<<(x);

В частности, это означает, что если несколько объектов выводятся с помощью одного оператора вывода, то они будут выдаваться в естественном порядке: слева - направо.

Функция ostream::operator<<(int) выводит целые значения, а функция ostream::operator<<(char) - символьные. Поэтому функция

void val(char c)
{
  cout << "int('"<< c <<"') = " << int(c) << '\n';
}

печатает целые значения символов и с помощью программы

main()
{
  val('A');
  val('Z');
}

будет напечатано

int('A') = 65
int('Z') = 90

Здесь предполагается кодировка символов ASCII, на вашей машине может быть иной результат. Обратите внимание, что символьная константа имеет тип char, поэтому cout<<'Z' напечатает букву Z, а вовсе не целое 90.

Функция ostream::operator<<(const void*) напечатает значение указателя в такой записи, которая более подходит для используемой системы адресации.

Программа

main()
{
 int i = 0;
 int* p = new int(1);
 cout << "local " << i
      << ", free store " << p << '\n';
}

выдаст на машине, используемой автором,

local 0x7fffead0, free store 0x500c

Для других систем адресации могут быть иные соглашения об изображении значений указателей.

Обсуждение базового класса ios отложим до 10.4.1.

10.2.2 Вывод пользовательских типов

Рассмотрим пользовательский тип данных:

class complex {
   double re, im;
public:
   complex(double r = 0, double i = 0) { re=r; im=i; }

   friend double real(complex a) { return a.re; }
   friend double imag(complex a) { return a.im; }

   friend complex operator+(complex, complex);
   friend complex operator-(complex, complex);
   friend complex operator*(complex, complex);
   friend complex operator/(complex, complex);
   //...
};

Для нового типа complex операцию << можно определить так:

ostream operator<<(ostreams, complex z)
{
 return s << '(' << real(z) << ',' << imag(z) << ')';
};

и использовать как operator<< для встроенных типов. Например,

main()
{
    complex x(1,2);
    cout << "x = " << x << '\n';
}

выдаст

x = (1,2)

Для определения операции вывода над пользовательскими типами данных не нужно модифицировать описание класса ostream, не требуется и доступ к структурам данных, скрытым в описании класса. Последнее очень кстати, поскольку описание класса ostream находится среди стандартных заголовочных файлов, доступ по записи к которым закрыт для большинства пользователей, и изменять которые они вряд ли захотят, даже если бы могли. Это важно и по той причине, что дает защиту от случайной порчи этих структур данных. Кроме того имеется возможность изменить реализацию ostream, не затрагивая пользовательских программ.

10.3 Ввод

Ввод во многом сходен с выводом. Есть класс istream, который реализует операцию ввода >> ("ввести из" - "input from") для небольшого набора стандартных типов. Для пользовательских типов можно определить функцию operator>>.

10.3.1 Ввод встроенных типов

Класс istream определяется следующим образом:

class istream : public virtual ios {
    //...
public:
    istream operator>>(char*);     // строка
    istream operator>>(char);     // символ
    istream operator>>(short);
    istream operator>>(int);
    istream operator>>(long);
    istream operator>>(float);
    istream operator>>(double);
    //...
};

Функции ввода operator>> определяются так:

istream istream::operator>>(T tvar)
{
 // пропускаем обобщенные пробелы
 // каким-то образом читаем T в`tvar'
  return *this;
 }

Теперь можно ввести в VECTOR последовательность целых, разделяемых пробелами, с помощью функции:

int readints(Vector<int> v)
// возвращаем число прочитанных целых
{
   for (int i = 0; i<v.size(); i++)
   {
      if (cin>>v[i]) continue;
      return i;
   }
   // слишком много целых для размера Vector
   // нужна соответствующая обработка ошибки
 }

Появление значения с типом, отличным от int, приводит к прекращению операции ввода, и цикл ввода завершается. Так, если мы вводим

1 2 3 4 5. 6 7 8.

то функция readints() прочитает пять целых чисел

1 2 3 4 5

Символ точка останется первым символом, подлежащим вводу. Под пробелом, как определено в стандарте С, понимается обобщенный пробел, т.е. пробел, табуляция, конец строки, перевод строки или возврат каретки. Проверка на обобщенный пробел возможна с помощью функции isspace() из файла <ctype.h>.

В качестве альтернативы можно использовать функции get():

class istream : public virtual ios {
    //...
    istream get(char c);     // символ
    istream get(char* p, int n, char ='n');   // строка
};

В них обобщенный пробел рассматривается как любой другой символ, и они предназначены для таких операций ввода, когда не делается никаких предположений о вводимых символах.

Функция istream::get(char) вводит один символ в свой параметр. Поэтому программу посимвольного копирования можно написать так:

main()
{
  char c;
  while (cin.get(c)) cout << c;
}

Такая запись выглядит несимметрично, и у операции >> для вывода символов есть двойник под именем put(), так что можно писать и так:

main()
{
   char c;
   while (cin.get(c)) cout.put(c);
}

Функция с тремя параметрами istream::get() вводит в символьный вектор не более n символов, начиная с адреса p. При всяком обращении к get() все символы, помещенные в буфер (если они были), завершаются 0, поэтому если второй параметр равен n, то введено не более n-1 символов. Третий параметр определяет символ, завершающий ввод. Типичное использование функции get() с тремя параметрами сводится к чтению строки в буфер заданного размера для ее дальнейшего разбора, например так:

void f()
{
    char buf[100];
    cin >> buf; // подозрительно
    cin.get(buf,100,'\n');      // надежно
    //...
 }

Операция cin>>buf подозрительна, поскольку строка из более чем 99 символов переполнит буфер. Если обнаружен завершающий символ, то он остается в потоке первым символом подлежащим вводу. Это позволяет проверять буфер на переполнение:

void f()
{
   char buf[100];

   cin.get(buf,100,'\n');   // надежно

   char c;
   if (cin.get(c)  c!='\n') {
      // входная строка больше, чем ожидалось
   }
   //...
 }

Естественно, существует версия get() для типа unsigned char.

В стандартном заголовочном файле <ctype.h> определены несколько функций, полезных для обработки при вводе:

int isalpha(char)   // 'a'..'z' 'A'..'Z'
int isupper(char)   // 'A'..'Z'
int islower(char)   // 'a'..'z'
int isdigit(char)   // '0'..'9'
int isxdigit(char)  // '0'..'9' 'a'..'f' 'A'..'F'
int isspace(char)   // ' ' '\t' возвращает конец строки
    // и перевод формата
int iscntrl(char)   // управляющий символ в диапазоне
    // (ASCII 0..31 и 127)
int ispunct(char)   // знак пунктуации, отличен от приведенных выше
int isalnum(char)   // isalpha() | isdigit()
int isprint(char)   // видимый: ascii ' '..'~'
int isgraph(char)     // isalpha() | isdigit() | ispunct()
int isascii(char c)   { return 0<=c  c<=127; }

Все они, кроме isascii(), работают с помощью простого просмотра, используя символ как индекс в таблице атрибутов символов. Поэтому вместо выражения типа

(('a'<=c  c<='z') || ('A'<=c  c<='Z')) // буква

которое не только утомительно писать, но оно может быть и ошибочным (на машине с кодировкой EBCDIC оно задает не только буквы), лучше использовать вызов стандартной функции isalpha(), который к тому же более эффективен.

В качестве примера приведем функцию eatwhite(), которая читает из потока обобщенные пробелы:

istream eatwhite(istream is)
{
     char c;
     while (is.get(c)) {
         if (isspace(c)==0) {
             is.putback(c);
             break;
         }
      }
      return is;
 }

В ней используется функция putback(), которая возвращает символ в поток, и он становится первым подлежащим чтению.

10.3.2 Состояния потока

С каждым потоком ( istream или ostream ) связано определенное состояние. Нестандартные ситуации и ошибки обрабатываются с помощью проверки и установки состояния подходящим образом.

Узнать состояние потока можно с помощью операций над классом ios:

class ios { //ios является базовым для ostream и istream
    //...
public:
    int eof() const;     // дошли до конца файла
    int fail() const;    // следующая операция будет неудачна
    int bad() const;     // поток испорчен
    int good() const;    // следующая операция будет успешной
    //...
};

Последняя операция ввода считается успешной, если состояние задается good() или eof(). Если состояние задается good(), то последующая операция ввода может быть успешной, в противном случае она будет неудачной. Применение операции ввода к потоку в состоянии, задаваемом не good(), считается пустой операцией. Если произошла неудача при попытке чтения в переменную v, то значение v не изменилось (оно не изменится, если v имеет тип, управляемый функциями члена из istream или ostream ). Различие между состояниями, задаваемыми как fail() или как bad() уловить трудно, и оно имеет смысл только для разработчиков операций ввода. Если состояние есть fail(), то считается, что поток не поврежден, и никакие символы не пропали; о состоянии bad() ничего сказать нельзя.

Значения, обозначающие эти состояния, определены в классе ios:

class ios {
    //...
public:
    enum io_state {
        goodbit=0,
        eofbit=1,
        filebit=2,
        badbit=4,
    };
    //...
};

Истинные значения состояний зависят от реализации, и указанные значения приведены только, чтобы избежать синтаксически неправильных конструкций.

Проверять состояние потока можно следующим образом:

switch (cin.rdstate()) {
case ios::goodbit:
    // последняя операция с cin была успешной
    break;
case ios::eofbit:
    // в конце файла
    break;
 case ios::filebit:
    // некоторый анализ ошибки
    // возможно неплохой
    break;
  case ios::badbit:
    //  cin возможно испорчен
    break;
  }

В более ранних реализациях для значений состояний использовались глобальные имена. Это приводило к нежелательному засорению пространства именования, поэтому новые имена доступны только в пределах класса ios. Если вам необходимо использовать старые имена в сочетании с новой библиотекой, можно воспользоваться следующими определениями:

const int _good = ios::goodbit;
const int _bad = ios::badbit;
const int _file = ios::filebit;
const int _eof = ios::eofbit;

typedef ios::io_state state_value ;

Разработчики библиотек должны заботиться о том, чтобы не добавлять новых имен к глобальному пространству именования. Если элементы перечисления входят в общий интерфейс библиотеки, они всегда должны использоваться в классе с префиксами, например, как ios::goodbit и ios::io_state.

Для переменной любого типа, для которого определены операции << и >>, цикл копирования записывается следующим образом:

while (cin>>z) cout << z << '\n';

Если поток появляется в условии, то проверяется состояние потока, и условие выполняется (т.е. результат его не 0) только для состояния good(). Как раз в приведенном выше цикле проверяется состояние потока istream, что является результатом операции cin>>z. Чтобы узнать, почему произошла неудача в цикле или условии, надо проверить состояние. Такая проверка для потока реализуется с помощью операции приведения (7.3.2).

Так, если z является символьным вектором, то в приведенном цикле читается стандартный ввод и выдается для каждой строки стандартного вывода по одному слову (т.е. последовательности символов, не являющихся обобщенными пробелами). Если z имеет тип complex, то в этом цикле с помощью операций, определенных в 10.2.2 и 10.2.3, будут копироваться комплексные числа. Шаблонную функцию копирования для потоков со значениями произвольного типа можно написать следующим образом:

complex z;
iocopy(z,cin,cout);    // копирование complex

double d;
iocopy(d,cin,cout);    // копирование double
char c;
iocopy(c,cin,cout);    // копирование char

Поскольку надоедает проверять на корректность каждую операцию ввода- вывода, то распространенным источником ошибок являются именно те места в программе, где такой контроль существенен. Обычно операции вывода не проверяют, но иногда они могут завершиться неудачно. Потоковый ввод- вывод разрабатывался из того принципа, чтобы сделать исключительные ситуации легкодоступными, и тем самым упростить обработку ошибок в процессе ввода-вывода.

10.3.3 Ввод пользовательских типов

Операцию ввода для пользовательского типа можно определить в точности так же, как и операцию вывода, но для операции ввода существенно, чтобы второй параметр имел тип ссылки, например:

istream operator>>(istream s, complex a)
/*
   формат input рассчитан на complex; "f" обозначает float:
       f
       ( f )
       ( f , f )
*/
{
   double re = 0, im = 0;
   char   c = 0;

   s >> c;
   if (c == '(') {
       s >> re >> c;
       if (c == ',') s >> im >> c;
       if (c != ')') s.clear(ios::badbit); // установим состояние
   }
   else {
       s.putback(c);
       s >> re;
   }

   if (s) a = complex(re,im);
   return s;
}

Несмотря на сжатость кода, обрабатывающего ошибки, на самом деле учитывается большая часть ошибок. Инициализация локальной переменной с нужна для того, чтобы в нее не попало случайное значение, например '(', в случае неудачной операции. Последняя проверка состояния потока гарантирует, что параметр a получит значение только при успешном вводе.

Операция, устанавливающая состояние потока, названа clear() (здесь clear - очистить), поскольку чаще всего она используется для восстановления состояния потока как good() ; значением по умолчанию для параметра ios::clear() является ios::goodbit.

10.4 Форматирование

Все примеры из 10.2 содержали неформатированный вывод, который являлся преобразованием объекта в последовательность символов, задаваемую стандартными правилами, длина которой также определяется этими правилами. Часто программистам требуются более развитые возможности. Так, возникает потребность контролировать размер памяти, необходимой для операции вывода, и формат, используемый для выдачи чисел. Точно так же допустимо управление некоторыми аспектами ввода.

10.4.1 Класс ios

Большинство средств управления вводом-выводом сосредоточены в классе ios, который является базовым для ostream и istream. По сути здесь находится управление связью между istream или ostream и буфером, используемым для операций ввода-вывода. Именно класс ios контролирует, как символы попадают в буфер и как они выбираются оттуда. Так, в классе ios есть член, содержащий информацию об используемой при чтении или записи целых чисел системы счисления (десятичная, восьмеричная или шестнадцатеричная), о точности вещественных чисел и т.п., а также функции для проверки и установки значений переменных, управляющих потоком.

class ios {
    //...
public:
    ostream* tie(ostream* s);   // связать input и output
    ostream* tie();             // возвратить "tie"

int width(int w);               // установить поле width
int width() const;

char fill(char);                // установить символ заполнения
char fill() const;              // вернуть символ заполнения

long flags(long f);
long flags() const;

long setf(long setbits, long field);
long setf(long);
long unsetf(long);

int precision(int);             // установить точность для float
int precision() const;
int rdstate(); const;          // состояния потоков, см. 10.3.2
int eof() const;
int fail() const;
int bad() const;
int good() const;
void clear(int i=0);

//...
             };

В 10.3.2 описаны функции, работающие с состоянием потока, остальные приведены ниже.

10.4.1.1 Связывание потоков

Функция tie() может установить и разорвать связь между ostream и istream. Рассмотрим пример:

main()
{
  String s;
  cout << "Password: ";
  cin >> s;
  // ...
 }

Как можно гарантировать, что приглашение Password: появится на экране прежде, чем выполнится операция чтения? Вывод в cout и ввод из cin буферизуются, причем независимо, поэтому Password: появится только по завершении программы, когда закроется буфер вывода.

Решение состоит в том, чтобы связать cout и cin с помощью операции cin.tie(cout).

Если ostream связан с потоком istream, то буфер вывода выдается при каждой операции ввода над istream. Тогда операции

cout << "Password: ";
cin >> s;

эквивалентны

cout << "Password: ";
cout.flush();
cin >> s;

Обращение is.tie(0) разрывает связь между потоком is и потоком, с которым он был связан, если такой был. Подобно другим потоковым функциям, устанавливающим определенное значение, tie(s) возвращает предыдущее значение, т.е. значение связанного потока перед обращением или 0. Вызов без параметра tie() возвращает текущее значение.

10.4.1.2 Поля вывода

Функция width() устанавливает минимальное число символов, использующееся в последующей операции вывода числа или строки. Так в результате следующих операций

cout.width(4);
cout << '(' << 12 << ')';

получим число 12 в поле размером 4 символа, т.е.

(12)

Заполнение поля заданными символами или выравнивание можно установить с помощью функции fill(), например:

cout.width(4);
cout.fill('#');
cout << '(' << "ab" << ')';

напечатает

###(ab)

По умолчанию поле заполняется пробелами, а размер поля по умолчанию есть 0, что означает "столько символов, сколько нужно". Вернуть размеру поля стандартное значение можно с помощью вызова

cout.width(0); // ``столько символов, сколько надо''

Функция width() задает минимальное число символов. Если появится больше символов, они будут напечатаны все, поэтому

cout.width(4);
cout << '(' << "121212" << ")\n";

напечатает

(121212)

Причина, по которой разрешено переполнение поля, а не усечение вывода, в том, чтобы избежать зависания при выводе. Лучше получить правильную выдачу, выглядящую некрасиво, чем красивую выдачу, являющуюся неправильной.

Вызов width() влияет только на одну следующую за ним операцию вывода, поэтому

cout.width(4);
cout.fill('#');
cout << '(' << 12 << "),(" << '(' <<12 << ")\n";

напечатает

(##12),((12)

а не

(##12),(##12)

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

(##12#),(##12#
)

С помощью стандартного манипулятора, показанного в 10.4.2.1, можно более элегантно задавать размера поля вывода.

10.4.1.3 Состояние формата

В классе ios содержится состояние формата, которое управляется функциями flags() и setf(). По сути эти функции нужны, чтобы установить или отменить следующие флаги:

class ios {
public:
       // управляющие форматом флаги:
   enum {
       skipws=01,          // пропуск обобщенных пробелов для input
       // поле выравнивания:
       left=02,            // добавление перед значением
       right=04,           // добавление после значения
       internal=010,       // добавление между знаком и значением
       // основание целого:
       dec=020,            // восьмеричное
       oct=040,            // десятичное
       hex=0100,           // шестнадцатеричное
       showbase=0200,      // показать основание целого
       showpoint=0400,     // выдать нули в конце
       uppercase=01000,    // 'E', 'X' , а не 'e', 'x'
       showpos=02000,      //  '+' для положительных чисел
       // запись числа типа float:
       scientific=04000,   // .dddddd Edd
       fixed=010000,       // dddd.dd
       // сброс в выходной поток:
       unitbuf=020000,     // после каждой операции
       stdio=040000        // после каждого символа
    };
    //...
};

Смысл флагов будет разъяснен в последующих разделах. Конкретные значения флагов зависят от реализации и даны здесь только для того, чтобы избежать синтаксически неверных конструкций.

Определение интерфейса как набора флагов и операций для их установки или отмены - это оцененный временем, хотя и несколько устаревший прием. Основное его достоинство в том, что пользователь может собрать воедино набор флагов, например, так:

const int my_io_options =
   ios::left|ios::oct|ios::showpoint|ios::fixed;

Такое множество флагов можно задавать как параметр одной операции

cout.flags(my_io_options);

а также просто передавать между функциями одной программы:

void your_function(int ios_options);

void my_function()
{
   // ...
  your_function(my_io_options);
  // ...
}

Множество флагов можно установить с помощью функции flags(), например:

void your_function(int ios_options)
{
 int old_options = cout.flags(ios_options);
 // ...
 cout.flags(old_options);  // reset options
 }

Функция flags() возвращает старое значение множества флагов. Это позволяет переустановить значения всех флагов, как показано выше, а также задать значение отдельному флагу. Например вызов

myostream.flags(myostream.flags()|ios::showpos);

заставляет класс myostream выдавать положительные числа со знаком + и, в то же время, не меняет значения других флагов. Получается старое значение множества флагов, к которому добавляется с помощью операции | флаг showpos. Функция setf( ) делает то же самое, поэтому эквивалентная запись имеет вид

myostream.setf(ios::showpos);

После установки флаг сохраняет значение до явной отмены.

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