Стенли Липпман - Язык программирования C++. Пятое издание

Таблица 17.18. Манипуляторы, определенные в объекте iomanip

Ранее в программах уже использовался манипулятор endl, который "записывался" в поток вывода как будто это значение. Но манипулятор endl— не обычное значение; он выполняет операцию: выводит символ новой строки и сбрасывает буфер.

Манипуляторы используются для двух общих категорий управления выводом: контроль представления числовых значений, а также контроль количества и расположения заполнителей. Большинство манипуляторов, изменяющих флаг формата, предоставлены парами для установки и сброса; один манипулятор устанавливает флаг формата в новое значение, а другой сбрасывает его, восстанавливая стандартное значение.

Манипуляторы, изменяющие флаг формата потока, обычно оставляют флаг формата измененным для всего последующего ввода-вывода.

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

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

Хорошим примером манипулятора, изменяющего состояние формата своего объекта, является манипулятор boolalpha. По умолчанию значение типа boolвыводится как 1или 0. Значение trueвыводится как целое число 1, а значение falseкак 0. Это поведение можно переопределить, применив к потоку манипулятор boolalpha:

cout << "default bool values: " << true << " " << false

<< "\nalpha bool values: " << boolalpha

<< true << " " << false << endl;

Эта программа выводит следующее:

default bool values: 1 0

alpha bool values: true false

Как только манипулятор boolalpha"записан" в поток cout, способ вывода логических значений изменяется. Последующие операции вывода логических значений отобразят их как "true"или "false".

Чтобы отменить изменение флага формата потока cout, применяется манипулятор noboolalpha:

bool bool_val = get_status();

cout << boolalpha // устанавливает внутреннее состояние cout

<< bool_val

<< noboolalpha; // возвращает стандартное внутреннее состояние

Здесь формат вывода логических значений изменен только для вывода значения bool_val. Как только это значение будет выведено, поток немедленно возвращается в первоначальное состояние.

По умолчанию целочисленные значения выводятся и читаются в десятичном формате. Используя манипуляторы hex, octи dec, базу записи числа можно изменить на восьмеричную, шестнадцатеричную и обратно на десятичную базу:

cout << "default: " << 20 << " " << 1024 << endl;

cout << "octal: " << oct << 20 << " " << 1024 << endl;

cout << "hex: " << hex << 20 << " " << 1024 << endl;

cout << "decimal: " << dec << 20 << " " << 1024 << endl;

После компиляции и запуска на выполнение эта программа выводит следующее:

default: 20 1024

octal: 24 2000

hex: 14 400

decimal: 20 1024

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

Манипуляторы hex, octи decвлияют на вывод только целочисленных операндов, но не значений с плавающей запятой.

По умолчанию при выводе числа нет никакого визуального уведомления об используемой базе. Например, 20 — это действительно 20, или восьмеричное представление числа 16? Когда числа выводятся в десятичном режиме, они отображаются, как и ожидается. Если необходимо выводить восьмеричные или шестнадцатеричные значения, вероятней всего, придется использовать также манипулятор showbase. Он заставляет поток вывода использовать те же соглашения, что и при определении базы целочисленных констант.

• Предваряющий 0xозначает шестнадцатеричный формат.

• Предваряющий 0означает восьмеричный формат.

• Отсутствие любого индикатора означает десятичное число.

Здесь предыдущая программа пересмотрена для использования манипулятора showbase:

cout << showbase; // отображать базу при выводе целочисленных значений

cout << "default: " << 20 << " " << 1024 << endl;

cout << "in octal: " << oct << 20 << " " << 1024 << endl;

cout << "in hex: " << hex << 20 << " " << 1024 << endl;

cout << "in decimal: " << dec << 20 << " " << 1024 << endl;

cout << noshowbase; // возвратить состояние потока

Вывод пересмотренной программы проясняет смысл:

default: 20 1024

in octal: 024 02000

in hex: 0x14 0x400

in decimal: 20 1024

Манипулятор noshowbaseвозвращает поток coutв прежнее состояние, когда индикатор базы не отображается.

По умолчанию шестнадцатеричные значения выводятся в нижнем регистре с x, также в нижним регистре. Манипулятор uppercaseпозволяет отобразить Xи шестнадцатеричные цифры a-fв верхнем регистре:

cout << uppercase << showbase << hex

<< "printed in hexadecimal: " << 20 << " " << 1024

<< nouppercase << noshowbase << dec << endl;

Этот оператор создает следующий вывод:

printed in hexadecimal: 0X14 0X400

Манипуляторы nouppercase, noshowbaseи decприменяются для возвращения потока в исходное состояние.

Контролировать можно три аспекта вывода числа с плавающей запятой.