Поиск…


Вступление

Манипуляторы - это специальные вспомогательные функции, которые помогают управлять входными и выходными потоками с помощью operator >> или operator << .

Все они могут быть включены в #include <iomanip> .

замечания

Манипуляторы могут использоваться другим способом. Например:

  1. os.width(n); равно os << std::setw(n);
    is.width(n); равно to is >> std::setw(n);

  1. os.precision(n); равно os << std::setprecision(n);
    is.precision(n); равно to is >> std::setprecision(n);

  1. os.setfill(c); равно os << std::setfill(c);

  1. str >> std::setbase(base); или str << std::setbase(base); равно
str.setf(base ==  8 ? std::ios_base::oct :
            base == 10 ? std::ios_base::dec :
                base == 16 ? std::ios_base::hex :
                     std::ios_base::fmtflags(0),
         std::ios_base::basefield);

  1. os.setf(std::ios_base::flag); равно os << std::flag;
    is.setf(std::ios_base::flag); равно to is >> std::flag;

    os.unsetf(std::ios_base::flag); равно os << std::no ## flag;
    is.unsetf(std::ios_base::flag); equals to is >> std::no ## flag;

    (где ## - оператор конкатенации )

    на следующий flag с: boolalpha , showbase , showpoint , showpos , skipws , uppercase .

  1. std::ios_base::basefield .
    Для flag s: dec , hex и oct :
  • os.setf(std::ios_base::flag, std::ios_base::basefield); равно os << std::flag;
    is.setf(std::ios_base::flag, std::ios_base::basefield); равно to is >> std::flag;
    (1)

  • str.unsetf(std::ios_base::flag, std::ios_base::basefield); равно str.setf(std::ios_base::fmtflags(0), std::ios_base::basefield);
    (2)

  1. std::ios_base::adjustfield .
    Для flag s: left , right и internal :
  • os.setf(std::ios_base::flag, std::ios_base::adjustfield); равно os << std::flag;
    is.setf(std::ios_base::flag, std::ios_base::adjustfield); равно to is >> std::flag;
    (1)

  • str.unsetf(std::ios_base::flag, std::ios_base::adjustfield); равно str.setf(std::ios_base::fmtflags(0), std::ios_base::adjustfield);
    (2)

(1) Если флаг соответствующего поля, ранее установленного, уже отключен unsetf .
(2) Если установлен flag .

  1. std::ios_base::floatfield .
  • os.setf(std::ios_base::flag, std::ios_base::floatfield); равно os << std::flag;
    is.setf(std::ios_base::flag, std::ios_base::floatfield); равно to is >> std::flag;

    для flag s: fixed и scientific .

  • os.setf(std::ios_base::fmtflags(0), std::ios_base::floatfield); равно os << std::defaultfloat;
    is.setf(std::ios_base::fmtflags(0), std::ios_base::floatfield); equals to is >> std::defaultfloat;

  1. str.setf(std::ios_base::fmtflags(0), std::ios_base::flag); равно str.unsetf(std::ios_base::flag)

    для flag s: basefield , adjustfield , floatfield .

  1. os.setf(mask) равна os << setiosflags(mask);
    is.setf(mask) равна is >> setiosflags(mask);

    os.unsetf(mask) равна os << resetiosflags(mask);
    is.unsetf(mask) равно to is >> resetiosflags(mask);

    Для почти всей mask типа std::ios_base::fmtflags .

Потолочные манипуляторы

std::boolalpha и std::noboolalpha - переключаться между текстовым и числовым представлением булевых.

std::cout << std::boolalpha << 1;
// Output: true

std::cout << std::noboolalpha << false;
// Output: 0

bool boolValue;
std::cin >> std::boolalpha >> boolValue;
std::cout << "Value \"" << std::boolalpha << boolValue
          << "\" was parsed as " << std::noboolalpha << boolValue;
// Input: true
// Output: Value "true" was parsed as 0

std::showbase и std::noshowbase - контролирует, используется ли префикс, указывающий числовую базу.

std::dec (десятичный), std::hex (шестнадцатеричный) и std::oct (восьмеричный) - используются для изменения базы для целых чисел.

#include <sstream>

std::cout << std::dec << 29 << ' - '
          << std::hex << 29 << ' - '
          << std::showbase << std::oct << 29 << ' - '
          << std::noshowbase << 29  '\n';
int number;
std::istringstream("3B") >> std::hex >> number;
std::cout << std::dec << 10;
// Output: 22 - 1D - 35 - 035
// 59

Значения по умолчанию: std::ios_base::noshowbase и std::ios_base::dec .

Если вы хотите больше узнать о std::istringstream просмотрите заголовок < sstream >.


std::uppercase std::nouppercase и std::nouppercase - управляют ли символы верхнего регистра в выводе с плавающей запятой и шестнадцатеричным целым числом. Не влияют на входные потоки.

std::cout << std::hex << std::showbase
              << "0x2a with nouppercase: " << std::nouppercase << 0x2a << '\n'
              << "1e-10 with uppercase: " << std::uppercase << 1e-10 << '\n'
}
// Output: 0x2a with nouppercase: 0x2a
// 1e-10 with uppercase: 1E-10

По умолчанию используется std::nouppercase .


std::setw(n) - изменяет ширину следующего поля ввода / вывода на ровно n .

Свойство width n сбрасывается до 0 когда вызываются некоторые функции (полный список здесь ).

std::cout << "no setw:" << 51 << '\n'
          << "setw(7): " << std::setw(7) << 51 << '\n'
          << "setw(7), more output: " << 13
          << std::setw(7) << std::setfill('*') << 67 << ' ' << 94 << '\n';

char* input = "Hello, world!";
char arr[10];
std::cin >> std::setw(6) >> arr;
std::cout << "Input from \"Hello, world!\" with setw(6) gave \"" << arr << "\"\n";

// Output: 51
// setw(7):      51
// setw(7), more output: 13*****67 94

// Input: Hello, world!
// Output: Input from "Hello, world!" with setw(6) gave "Hello"

По умолчанию используется std::setw(0) .


std::left , std::right и std::internal - изменение позиции по умолчанию для символов заполнения путем установки std::ios_base::adjustfield в std::ios_base::left , std::ios_base::right и std::ios_base::internal соответственно. std::left и std::right применяются к любому выходу, std::internal - для целых чисел, с плавающей запятой и денежных средств. Не влияют на входные потоки.

#include <locale>
...

std::cout.imbue(std::locale("en_US.utf8"));

std::cout << std::left << std::showbase << std::setfill('*')
          << "flt: " << std::setw(15) << -9.87  << '\n'
          << "hex: " << std::setw(15) << 41 << '\n'
          << "  $: " << std::setw(15) << std::put_money(367, false) << '\n'
          << "usd: " << std::setw(15) << std::put_money(367, true) << '\n'
          << "usd: " << std::setw(15)
          << std::setfill(' ') << std::put_money(367, false) << '\n';
// Output:
// flt: -9.87**********
// hex: 41*************
//   $: $3.67**********
// usd: USD *3.67******
// usd: $3.67          

std::cout << std::internal << std::showbase << std::setfill('*')
          << "flt: " << std::setw(15) << -9.87  << '\n'
          << "hex: " << std::setw(15) << 41 << '\n'
          << "  $: " << std::setw(15) << std::put_money(367, false) << '\n'
          << "usd: " << std::setw(15) << std::put_money(367, true) << '\n'
          << "usd: " << std::setw(15)
          << std::setfill(' ') << std::put_money(367, true) << '\n';
// Output:
// flt: -**********9.87
// hex: *************41
//   $: $3.67**********
// usd: USD *******3.67
// usd: USD        3.67

std::cout << std::right << std::showbase << std::setfill('*')
          << "flt: " << std::setw(15) << -9.87  << '\n'
          << "hex: " << std::setw(15) << 41 << '\n'
          << "  $: " << std::setw(15) << std::put_money(367, false) << '\n'
          << "usd: " << std::setw(15) << std::put_money(367, true) << '\n'
          << "usd: " << std::setw(15)
          << std::setfill(' ') << std::put_money(367, true) << '\n';
// Output:
// flt: **********-9.87
// hex: *************41
//   $: **********$3.67
// usd: ******USD *3.67
// usd:       USD  3.67

По умолчанию std::left .


std::fixed , std::scientific , std::hexfloat [C ++ 11] и std::defaultfloat [C ++ 11] - изменение форматирования для ввода / вывода с плавающей запятой.

std::fixed устанавливает std::ios_base::floatfield в std::ios_base::fixed ,
std::scientific - to std::ios_base::scientific ,
std::hexfloat - to std::ios_base::fixed | std::ios_base::scientific и
std::defaultfloat - to std::ios_base::fmtflags(0) .

fmtflags

#include <sstream>
...

std::cout << '\n'
          << "The number 0.07 in fixed:      " << std::fixed << 0.01 << '\n'
          << "The number 0.07 in scientific: " << std::scientific << 0.01 << '\n'
          << "The number 0.07 in hexfloat:   " << std::hexfloat << 0.01 << '\n'
          << "The number 0.07 in default:    " << std::defaultfloat << 0.01 << '\n';

double f;
std::istringstream is("0x1P-1022");
double f = std::strtod(is.str().c_str(), NULL);
std::cout << "Parsing 0x1P-1022 as hex gives " << f << '\n';

// Output:
// The number 0.01 in fixed:      0.070000
// The number 0.01 in scientific: 7.000000e-02
// The number 0.01 in hexfloat:   0x1.1eb851eb851ecp-4
// The number 0.01 in default:    0.07
// Parsing 0x1P-1022 as hex gives 2.22507e-308

По умолчанию используется std::ios_base::fmtflags(0) .

В некоторых компиляторах есть ошибка, которая вызывает

double f;
std::istringstream("0x1P-1022") >> std::hexfloat >> f;
std::cout << "Parsing 0x1P-1022 as hex gives " << f << '\n';
// Output: Parsing 0x1P-1022 as hex gives 0

std::showpoint и std::noshowpoint - контролировать, всегда ли десятичная точка включена в представление с плавающей запятой. Не влияют на входные потоки.

std::cout << "7.0 with showpoint: " << std::showpoint << 7.0 << '\n'
          << "7.0 with noshowpoint: " << std::noshowpoint << 7.0 << '\n';
// Output: 1.0 with showpoint: 7.00000
// 1.0 with noshowpoint: 7

По умолчанию используется std::showpoint .


std::showpos и std::noshowpos - контроль отображения знака + в неотрицательном выходе. Не влияют на входные потоки.

std::cout << "With showpos: " << std::showpos
          << 0 << ' ' << -2.718 << ' ' << 17 << '\n'
          << "Without showpos: " << std::noshowpos
          << 0 << ' ' << -2.718 << ' ' << 17 << '\n';
// Output: With showpos: +0 -2.718 +17
// Without showpos: 0 -2.718 17

По умолчанию, если std::noshowpos .


std::unitbuf , std::nounitbuf - контроль потока промывки после каждой операции. Не влияют на входной поток. std::unitbuf вызывает промывку.


std::setbase(base) - устанавливает числовую базу потока.

std::setbase(8) равно std::ios_base::basefield для std::ios_base::oct ,
std::setbase(16) - to std::ios_base::hex ,
std::setbase(10) - to std::ios_base::dec .

Если base другая, то 8 , 10 или 16 тогда std::ios_base::basefield устанавливает значение std::ios_base::fmtflags(0) . Это означает десятичный выход и вход, зависящий от префикса.

По умолчанию std::ios_base::basefield - std::ios_base::dec затем по умолчанию std::setbase(10) .


std::setprecision(n) - изменяет точность с плавающей запятой.

#include <cmath>
#include <limits>
...

typedef std::numeric_limits<long double> ld;
const long double pi = std::acos(-1.L);

std::cout << '\n'
          << "default precision (6):   pi: " << pi << '\n'
          << "                       10pi: " << 10 * pi << '\n'
          << "std::setprecision(4):  10pi: " << std::setprecision(4) << 10 * pi << '\n'
          << "                    10000pi: " << 10000 * pi << '\n'
          << "std::fixed:         10000pi: " << std::fixed << 10000 * pi << std::defaultfloat << '\n'
          << "std::setprecision(10):   pi: " << std::setprecision(10) << pi << '\n'
          << "max-1 radix precicion:   pi: " << std::setprecision(ld::digits - 1) << pi << '\n'
          << "max+1 radix precision:   pi: " << std::setprecision(ld::digits + 1) << pi << '\n'
          << "significant digits prec: pi: " << std::setprecision(ld::digits10) << pi << '\n';

// Output:
// default precision (6):   pi: 3.14159
//                        10pi: 31.4159
// std::setprecision(4):  10pi: 31.42
//                     10000pi: 3.142e+04
// std::fixed:         10000pi: 31415.9265
// std::setprecision(10):   pi: 3.141592654
// max-1 radix precicion:   pi: 3.14159265358979323851280895940618620443274267017841339111328125
// max+1 radix precision:   pi: 3.14159265358979323851280895940618620443274267017841339111328125
// significant digits prec: pi: 3.14159265358979324

По умолчанию используется std::setprecision(6) .


std::setiosflags(mask) и std::resetiosflags(mask) - установить и очистить флаги, указанные в mask std::ios_base::fmtflags .

#include <sstream>
...

std::istringstream in("10 010 10 010 10 010");
int num1, num2;

in >> std::oct >> num1 >> num2;
std::cout << "Parsing \"10 010\" with std::oct gives:   " << num1 << ' ' << num2 << '\n';
// Output: Parsing "10 010" with std::oct gives:   8 8

in >> std::dec >> num1 >> num2;
std::cout << "Parsing \"10 010\" with std::dec gives:   " << num1 << ' ' << num2 << '\n';
// Output: Parsing "10 010" with std::oct gives:   10 10

in >> std::resetiosflags(std::ios_base::basefield) >> num1 >> num2;
std::cout << "Parsing \"10 010\" with autodetect gives: " << num1 << ' ' << num2 << '\n';
// Parsing "10 010" with autodetect gives: 10 8

std::cout << std::setiosflags(std::ios_base::hex |
                              std::ios_base::uppercase |
                              std::ios_base::showbase) << 42 << '\n';
// Output: OX2A

std::skipws и std::noskipws - контроль пропуска пропущенных пробелов форматированными входными функциями. Не влияют на выходные потоки.

#include <sstream>
...

char c1, c2, c3;
std::istringstream("a b c") >> c1 >> c2 >> c3;
std::cout << "Default  behavior:  c1 = " << c1 << "  c2 = " << c2 << "  c3 = " << c3 << '\n';

std::istringstream("a b c") >> std::noskipws >> c1 >> c2 >> c3;
std::cout << "noskipws behavior:  c1 = " << c1 << "  c2 = " << c2 << "  c3 = " << c3 << '\n';
// Output: Default  behavior:  c1 = a  c2 = b  c3 = c
// noskipws behavior:  c1 = a  c2 =    c3 = b

По умолчанию используется std::ios_base::skipws .


std::quoted(s[, delim[, escape]]) [C ++ 14] - вставляет или извлекает цитируемые строки со встроенными пространствами.

s - строка для вставки или извлечения.
delim - символ для использования в качестве разделителя " по умолчанию.
escape - символ, который будет использоваться как escape-символ, \ по умолчанию.

#include <sstream>
...
 
std::stringstream ss;
std::string in = "String with spaces, and embedded \"quotes\" too";
std::string out;
 
ss << std::quoted(in);
std::cout << "read in     [" << in << "]\n"
          << "stored as   [" << ss.str() << "]\n";
 
ss >> std::quoted(out);
std::cout << "written out [" << out << "]\n";
// Output:
// read in     [String with spaces, and embedded "quotes" too]
// stored as   ["String with spaces, and embedded \"quotes\" too"]
// written out [String with spaces, and embedded "quotes" too]

Для получения дополнительной информации см. Ссылку выше.

Манипуляторы выходного потока

std::ends - вставляет нулевой символ '\0' для вывода потока. Более формально это объявление манипулятора выглядит так:

template <class charT, class traits>
std::basic_ostream<charT, traits>& ends(std::basic_ostream<charT, traits>& os);

и этот манипулятор помещает символ, вызывая os.put(charT()) при использовании в выражении
os << std::ends;


std::endl и std::flush поток потока flush out вызывая out.flush() . Это приводит к немедленному производству продукции. Но std::endl вставляет конец строки '\n' символ перед промывкой.

std::cout << "First line." << std::endl << "Second line. " << std::flush
          << "Still second line.";
// Output: First line.
// Second line. Still second line.

std::setfill(c) - изменяет символ заполнения на c . Часто используется с std::setw .

std::cout << "\nDefault fill: " << std::setw(10) << 79 << '\n'
          << "setfill('#'): " << std::setfill('#')
          << std::setw(10) << 42 << '\n';
// Output:
// Default fill:         79
// setfill('#'): ########79

std::put_money(mon[, intl]) [C ++ 11]. В выражении out << std::put_money(mon, intl) преобразуется денежное значение mon ( long double или std::basic_string type) в его представление символа, как определено гранью std::money_put языка, в настоящее время проникнутого в out . Используйте международные валютные строки, если intl true , иначе используйте символы валюты.

long double money = 123.45;
// or std::string money = "123.45";
 
std::cout.imbue(std::locale("en_US.utf8"));
std::cout << std::showbase << "en_US: " << std::put_money(money)
          << " or " << std::put_money(money, true) << '\n';
// Output: en_US: $1.23 or USD  1.23
 
std::cout.imbue(std::locale("ru_RU.utf8"));
std::cout << "ru_RU: " << std::put_money(money)
          << " or " << std::put_money(money, true) << '\n';
// Output: ru_RU: 1.23 руб or 1.23 RUB 
 
std::cout.imbue(std::locale("ja_JP.utf8"));
std::cout << "ja_JP: " << std::put_money(money)
          << " or " << std::put_money(money, true) << '\n';
// Output: ja_JP: ¥123 or JPY  123

std::put_time(tmb, fmt) [C ++ 11] - форматирует и выводит значение даты / времени в std::tm соответствии с указанным форматом fmt .

tmb - указатель на структуру календаря const std::tm* полученную из localtime() или gmtime() .
fmt - указатель на строку с нулевым символом const CharT* определяющую формат преобразования.

#include <ctime>
...

std::time_t t = std::time(nullptr);
std::tm tm = *std::localtime(&t);

std::cout.imbue(std::locale("ru_RU.utf8"));
std::cout << "\nru_RU: " << std::put_time(&tm, "%c %Z") << '\n';
// Possible output:
// ru_RU: Вт 04 июл 2017 15:08:35 UTC

Для получения дополнительной информации см. Ссылку выше.

Манипуляторы входного потока

std::ws - потребляет ведущие пробелы во входном потоке. Он отличается от std::skipws .

#include <sstream>
...

std::string str;
std::istringstream("  \v\n\r\t    Wow!There   is no whitespaces!") >> std::ws >> str;
std::cout << str;
// Output: Wow!There   is no whitespaces!

std::get_money(mon[, intl]) [C ++ 11]. В выражении in >> std::get_money(mon, intl) анализирует ввод символа как денежное значение, как указано в std::money_get аспекте локали, в настоящее время std::money_get in , и сохраняет значение в mon ( long double или std::basic_string ). Манипулятор ожидает, что требуемые международные валютные строки, если intl true , ожидает дополнительных символов валюты в противном случае.

#include <sstream>
#include <locale>
...
 
std::istringstream in("$1,234.56 2.22 USD  3.33");
long double v1, v2;
std::string v3;

in.imbue(std::locale("en_US.UTF-8"));
in >> std::get_money(v1) >> std::get_money(v2) >> std::get_money(v3, true);
if (in) {
    std::cout << std::quoted(in.str()) << " parsed as: "
              << v1 << ", " << v2 << ", " << v3 << '\n';
}
// Output:
// "$1,234.56 2.22 USD  3.33" parsed as: 123456, 222, 333

std::get_time(tmb, fmt) [C ++ 11] - анализирует значение даты / времени, хранящееся в tmb указанного формата fmt .

tmb - действительный указатель на объект const std::tm* где будет сохранен результат.
fmt - указатель на строку с нулевым символом const CharT* определяющую формат преобразования.

#include <sstream>
#include <locale>
...

std::tm t = {};
std::istringstream ss("2011-Februar-18 23:12:34");

ss.imbue(std::locale("de_DE.utf-8"));
ss >> std::get_time(&t, "%Y-%b-%d %H:%M:%S");
if (ss.fail()) {
    std::cout << "Parse failed\n";
}
else {
    std::cout << std::put_time(&t, "%c") << '\n';
}
// Possible output:
// Sun Feb 18 23:12:34 2011

Для получения дополнительной информации см. Ссылку выше.



Modified text is an extract of the original Stack Overflow Documentation
Лицензировано согласно CC BY-SA 3.0
Не связан с Stack Overflow