Share via

<iomanip> 函数

  • 项目

get_money
get_time
put_money
put_time
quoted
resetiosflags
setbase
setfill
setiosflags
setprecision
setw

get_money

使用指定格式从流中提取货币值，然后在参数中返回值。

template <class Money>
T7 get_money(Money& amount, bool use_intl);

参数

amount
提取的货币值。

use_intl
如果为 true，请使用国际格式。 默认值是 false。

备注

此操控器会返回一个对象，该对象在从流 str 中提取时会表现为 formatted input function，它会对与 str 关联的区域设置 Facet money_get 调用成员函数 get，其使用 use_intl 来指示国际格式。 如果成功，则调用会将提取的货币值存储在 amount 中。 此操控器随后返回 str。

Money 必须为 long double 类型，或者是具有与 str 相同的元素和特征参数的 basic_string 的实例化。

get_time

使用指定格式从流中提取时间值。 在参数中返回值作为时间结构。

template <class Elem>
T10 get_time(struct tm *time_ptr, const Elem *time_format);

参数

time_ptr
时间结构形式的时间。

time_format
用于获取时间值的格式。

备注

此操控器会返回一个对象，该对象在从流 str 中提取时会表现为 formatted input function，它为与 str 关联的区域设置 Facet time_get 调用成员函数 get，其使用 tptr 来指示时间结构，使用 fmt 来指示 null 终止格式字符串的开头。 如果成功，则调用会将与任何提取时间字段关联的值存储在时间结构中。 此操控器随后返回 str。

示例

#include <ctime>
#include <iomanip>
#include <iostream>

int main()
{
    std::cout << "Enter a time, for example 15:24 for 3:24pm: ";
    struct std::tm when;
    std::cin >> std::get_time(&when, "%R");
    if (!std::cin.fail())
    {
        std::cout << "Entered: " << when.tm_hour << " hours, " << when.tm_min << " minutes\n";
    }

    return (int)std::cin.fail();
}

put_money

使用特定格式将货币金额插入流中。

template <class Money>
T8 put_money(const Money& amount, bool use_intl);

参数

amount
要插入到流中的货币金额。

use_intl
如果操控器应使用国际格式，则设置为 true，否则设置为 false。

返回值

返回 str。

备注

此操控器会返回一个对象，该对象在插入到流 str 中时会表现为一个格式化输出函数，该函数会对与 str 关联的区域设置 Facet money_put 调用成员函数 put。 如果成功，则调用会插入格式正确的 amount，其使用 use_intl 来指示国际格式，将 str.fill() 用作填充元素。 此操控器随后返回 str。

Money 必须为 long double 类型，或者是具有与 str 相同的元素和特征参数的 basic_string 的实例化。

put_time

使用指定格式将时间值从时间结构写入流中。

template <class Elem>
T10 put_time(struct tm* time_ptr, const Elem* time_format);

参数

time_ptr
时间结构中提供的要写入到流中的时间值。

time_format
用来写入时间值的格式。

注解

操控器返回一个对象，该对象在插入到流 str 中时会表现为 formatted output function。 此输出函数会对与 str 关联的区域设置 Facet time_put 调用成员函数 put。 此输出函数使用 time_ptr 来指示时间结构，使用 time_format 来指示 null 终止格式字符串的开头。 如果成功，则调用会从格式字符串插入文字文本，从时间结构插入转换的值。 此操控器随后返回 str。

quoted

（C++14 中的新增功能）一个 iostream 操控器，它使用 >> 和 << 运算符，使字符串能够方便地往返进出流。

quoted(std::string str) // or wstring
quoted(const char* str) //or wchar_t*
quoted(std::string str, char delimiter, char escape) // or wide versions
quoted(const char* str, char delimiter, char escape) // or wide versions

参数

str
std::string、char*、字符串字面量或原始字符串字面量、或者其中任何一个的宽版本（例如 std::wstring、wchar_t*）。

delimiter
一个用户指定的字符或宽字符，用作字符串开头和结尾的分隔符。

escape
一个用户指定的字符或宽字符，用作字符串内转义序列的转义字符。

备注

请参阅使用插入运算符并控制格式。

示例

此示例显示如何通过窄字符串将 quoted 与默认分隔符和转义字符一起使用。 同样支持宽字符串。

#include <iostream>
#include <iomanip>
#include <sstream>

using namespace std;

void show_quoted_v_nonquoted()
{
    // Results are identical regardless of input string type:
    // string inserted { R"(This is a "sentence".)" }; // raw string literal
    // string inserted { "This is a \"sentence\"." };  // regular string literal
    const char* inserted = "This is a \"sentence\".";  // const char*
    stringstream ss, ss_quoted;
    string extracted, extracted_quoted;

    ss << inserted;
    ss_quoted << quoted(inserted);

    cout << "ss.str() is storing       : " << ss.str() << endl;
    cout << "ss_quoted.str() is storing: " << ss_quoted.str() << endl << endl;

    // Round-trip the strings
    ss >> extracted;
    ss_quoted >> quoted(extracted_quoted);

    cout << "After round trip: " << endl;
    cout << "Non-quoted      : " << extracted << endl;
    cout << "Quoted          : " << extracted_quoted << endl;
}

int main(int argc, char* argv[])
{
    show_quoted_v_nonquoted();

    // Keep console window open in debug mode.
    cout << endl << "Press Enter to exit" << endl;
    string input{};
    getline(cin, input);
}

/* Output:
ss.str() is storing       : This is a "sentence".
ss_quoted.str() is storing: "This is a \"sentence\"."

After round trip:
Non-quoted      : This
Quoted          : This is a "sentence".

Press Enter to exit
*/

以下示例显示如何提供自定义分隔符或转义字符：

#include <iostream>
#include <iomanip>
#include <sstream>

using namespace std;

void show_custom_delimiter()
{
    string inserted{ R"("This" "is" "a" "heavily-quoted" "sentence".)" };
    // string inserted{ "\"This\" \"is\" \"a\" \"heavily-quoted\" \"sentence\"" };
    // const char* inserted{ "\"This\" \"is\" \"a\" \"heavily-quoted\" \"sentence\"" };
    stringstream ss, ss_quoted;
    string extracted;

    ss_quoted << quoted(inserted, '*');
    ss << inserted;
    cout << "ss_quoted.str() is storing: " << ss_quoted.str() << endl;
    cout << "ss.str() is storing       : " << ss.str() << endl << endl;

    // Use the same quoted arguments as on insertion.
    ss_quoted >> quoted(extracted, '*');

    cout << "After round trip: " << endl;
    cout << "Quoted          : " << extracted << endl;

    extracted = {};
    ss >> extracted;
    cout << "Non-quoted      : " << extracted << endl << endl;
}

void show_custom_escape()
{
    string inserted{ R"(\\root\trunk\branch\nest\egg\yolk)" };
    // string inserted{ "\\\\root\\trunk\\branch\\nest\\egg\\yolk" };
    stringstream ss, ss_quoted, ss_quoted_custom;
    string extracted;

    // Use '"' as delimiter and '~' as escape character.
    ss_quoted_custom << quoted(inserted, '"', '~');
    ss_quoted << quoted(inserted);
    ss << inserted;
    cout << "ss_quoted_custom.str(): " << ss_quoted_custom.str() << endl;
    cout << "ss_quoted.str()       : " << ss_quoted.str() << endl;
    cout << "ss.str()              : " << ss.str() << endl << endl;

    // No spaces in this string, so non-quoted behaves same as quoted
    // after round-tripping.
}

int main(int argc, char* argv[])
{
    cout << "Custom delimiter:" << endl;
    show_custom_delimiter();
    cout << "Custom escape character:" << endl;
    show_custom_escape();

    // Keep console window open in debug mode.
    cout << endl << "Press Enter to exit" << endl;
    string input{};
    getline(cin, input);
}
/* Output:
Custom delimiter:
ss_quoted.str() is storing: *"This" "is" "a" "heavily-quoted" "sentence".*
ss.str() is storing       : "This" "is" "a" "heavily-quoted" "sentence".

After round trip:
Quoted          : "This" "is" "a" "heavily-quoted" "sentence".
Non-quoted      : "This"

Custom escape character:
ss_quoted_custom.str(): "\\root\trunk\branch\nest\egg\yolk"
ss_quoted.str()       : "\\\\root\\trunk\\branch\\nest\\egg\\yolk"
ss.str()              : \\root\trunk\branch\nest\egg\yolk

Press Enter to exit
*/

resetiosflags

清除指定标志。

T1 resetiosflags(ios_base::fmtflags mask);

参数

mask
要清除的标志。

返回值

操控器返回一个对象，该对象在从流 str 中提取或插入到该流时会调用 str.setf(ios_base::fmtflags, mask)，然后返回 str，请参阅 setf 和 fmtflags。

示例

有关使用 resetiosflags 的示例，请参阅 setw。

setbase

为整数设置基数。

T3 setbase(int base);

参数

base
数基。

返回值

操控器返回一个对象，该对象在从流 str 中提取或插入到该流时会调用 str.setf(mask, ios_base::basefield)，然后返回 str，请参阅 ios_base::basefield。 此处，mask 确定方式如下：

示例

有关使用 setbase 的示例，请参阅 setw。

setfill

设置用于在右对齐显示中填充空格的字符。

template <class Elem>
T4 setfill(Elem Ch);

参数

Ch
用于在右对齐显示中填充空格的字符。

返回值

模板操控器返回一个对象，该对象在从流 str 中提取或插入到该流时会调用 str.fill(Ch)，然后返回 str。 类型 Elem 必须与流 str 的元素类型相同。

示例

有关使用 setfill 的示例，请参阅 setw。

setiosflags

设置指定标志。

T2 setiosflags(ios_base::fmtflags mask);

参数

mask
要设置的标志。

返回值

操控器返回一个对象，该对象在从流 str 中提取或插入到该流时会调用 str.setf(mask)，然后返回 str，请参阅 setf。

示例

有关使用 setiosflags 的示例，请参阅 setw。

setprecision

为浮点值设置精度。

T5 setprecision(streamsize Prec);

参数

Prec
浮点值的精度。

返回值

操控器返回一个对象，该对象在从流 str 中提取或插入到该流时会调用 str.precision(Prec)，然后返回 str，请参阅 precision。

示例

有关使用 setprecision 的示例，请参阅 setw。

setw

为流中下一元素指定显示字段的宽度。

T6 setw(streamsize Wide);

参数

Wide
显示字段的宽度。

返回值

操控器返回一个对象，该对象在从流 str 中提取或插入到该流时会调用 str.width(Wide)，然后返回 str。 有关详细信息，请参阅 width。

备注

setw 仅设置流中下一元素的宽度，并且必须插入到要对其指定宽度的每个元素之前。

示例

// iomanip_setw.cpp
// compile with: /EHsc
// Defines the entry point for the console application.
//
// Sample use of the following manipulators:
//   resetiosflags
//   setiosflags
//   setbase
//   setfill
//   setprecision
//   setw

#include <iostream>
#include <iomanip>

using namespace std;

const double   d1 = 1.23456789;
const double   d2 = 12.3456789;
const double   d3 = 123.456789;
const double   d4 = 1234.56789;
const double   d5 = 12345.6789;
const long      l1 = 16;
const long      l2 = 256;
const long      l3 = 1024;
const long      l4 = 4096;
const long      l5 = 65536;
int         base = 10;

void DisplayDefault( )
{
   cout << endl << "default display" << endl;
   cout << "d1 = " << d1 << endl;
   cout << "d2 = " << d2 << endl;
   cout << "d3 = " << d3 << endl;
   cout << "d4 = " << d4 << endl;
   cout << "d5 = " << d5 << endl;
}

void DisplayWidth( int n )
{
   cout << endl << "fixed width display set to " << n << ".\n";
   cout << "d1 = " << setw(n) << d1 << endl;
   cout << "d2 = " << setw(n) << d2 << endl;
   cout << "d3 = " << setw(n) << d3 << endl;
   cout << "d4 = " << setw(n) << d4 << endl;
   cout << "d5 = " << setw(n) << d5 << endl;
}

void DisplayLongs( )
{
   cout << setbase(10);
   cout << endl << "setbase(" << base << ")" << endl;
   cout << setbase(base);
   cout << "l1 = " << l1 << endl;
   cout << "l2 = " << l2 << endl;
   cout << "l3 = " << l3 << endl;
   cout << "l4 = " << l4 << endl;
   cout << "l5 = " << l5 << endl;
}

int main( int argc, char* argv[] )
{
   DisplayDefault( );

   cout << endl << "setprecision(" << 3 << ")" << setprecision(3);
   DisplayDefault( );

   cout << endl << "setprecision(" << 12 << ")" << setprecision(12);
   DisplayDefault( );

   cout << setiosflags(ios_base::scientific);
   cout << endl << "setiosflags(" << ios_base::scientific << ")";
   DisplayDefault( );

   cout << resetiosflags(ios_base::scientific);
   cout << endl << "resetiosflags(" << ios_base::scientific << ")";
   DisplayDefault( );

   cout << endl << "setfill('" << 'S' << "')" << setfill('S');
   DisplayWidth(15);
   DisplayDefault( );

   cout << endl << "setfill('" << ' ' << "')" << setfill(' ');
   DisplayWidth(15);
   DisplayDefault( );

   cout << endl << "setprecision(" << 8 << ")" << setprecision(8);
   DisplayWidth(10);
   DisplayDefault( );

   base = 16;
   DisplayLongs( );

   base = 8;
   DisplayLongs( );

   base = 10;
   DisplayLongs( );

   return   0;
}

default display
d1 = 1.23457
d2 = 12.3457
d3 = 123.457
d4 = 1234.57
d5 = 12345.7

setprecision(3)
default display
d1 = 1.23
d2 = 12.3
d3 = 123
d4 = 1.23e+003
d5 = 1.23e+004

setprecision(12)
default display
d1 = 1.23456789
d2 = 12.3456789
d3 = 123.456789
d4 = 1234.56789
d5 = 12345.6789

setiosflags(4096)
default display
d1 = 1.234567890000e+000
d2 = 1.234567890000e+001
d3 = 1.234567890000e+002
d4 = 1.234567890000e+003
d5 = 1.234567890000e+004

resetiosflags(4096)
default display
d1 = 1.23456789
d2 = 12.3456789
d3 = 123.456789
d4 = 1234.56789
d5 = 12345.6789

setfill('S')
fixed width display set to 15.
d1 = SSSSS1.23456789
d2 = SSSSS12.3456789
d3 = SSSSS123.456789
d4 = SSSSS1234.56789
d5 = SSSSS12345.6789

default display
d1 = 1.23456789
d2 = 12.3456789
d3 = 123.456789
d4 = 1234.56789
d5 = 12345.6789

setfill(' ')
fixed width display set to 15.
d1 =      1.23456789
d2 =      12.3456789
d3 =      123.456789
d4 =      1234.56789
d5 =      12345.6789

default display
d1 = 1.23456789
d2 = 12.3456789
d3 = 123.456789
d4 = 1234.56789
d5 = 12345.6789

setprecision(8)
fixed width display set to 10.
d1 =  1.2345679
d2 =  12.345679
d3 =  123.45679
d4 =  1234.5679
d5 =  12345.679

default display
d1 = 1.2345679
d2 = 12.345679
d3 = 123.45679
d4 = 1234.5679
d5 = 12345.679

setbase(16)
l1 = 10
l2 = 100
l3 = 400
l4 = 1000
l5 = 10000

setbase(8)
l1 = 20
l2 = 400
l3 = 2000
l4 = 10000
l5 = 200000

setbase(10)
l1 = 16
l2 = 256
l3 = 1024
l4 = 4096
l5 = 65536

请参阅

<iomanip>