标准库头文件 <locale>
来自 cppreference.com
此头文件是 本地化 库的一部分。
类 | |
封装文化差异的一组多态构面 (类) | |
字符串和流转换 | |
(C++11)(C++17 中已弃用)(C++26 中已移除) |
执行宽字符串和字节字符串之间的转换 (类模板) |
(C++11)(C++17 中已弃用)(C++26 中已移除) |
执行字节流缓冲区和宽流缓冲区之间的转换 (类模板) |
构面类别基类 | |
定义字符分类类别 (类) | |
定义字符转换错误 (类) | |
定义消息目录类型 (类) | |
定义日期格式常量 (类) | |
定义货币格式模式 (类) | |
构面类别 | |
定义字符分类表 (类模板) | |
对类型 char 的 std::ctype 特化 (类模板特化) | |
在字符编码之间转换,包括 UTF-8、UTF-16、UTF-32 (类模板) | |
定义字符串的字典序比较和散列 (类模板) | |
实现从消息目录中检索字符串 (类模板) | |
将时间/日期值从输入字符序列解析为 std::tm (类模板) | |
将 std::tm 的内容格式化为输出的字符序列 (类模板) | |
从输入字符序列中解析数值 (类模板) | |
将数值格式化为输出的字符序列 (类模板) | |
定义数字标点规则 (类模板) | |
从输入字符序列中解析并构造货币值 (类模板) | |
将货币值格式化为输出的字符序列 (类模板) | |
定义 std::money_get 和 std::money_put 使用的货币格式参数 (类模板) | |
特定于区域设置的构面类别 | |
表示命名区域设置的系统提供的 std::ctype (类模板) | |
表示命名区域设置的系统提供的 std::codecvt (类模板) | |
表示命名区域设置的系统提供的 std::messages (类模板) | |
表示命名区域设置的系统提供的 std::collate (类模板) | |
表示命名区域设置的系统提供的 std::time_get (类模板) | |
表示命名区域设置的系统提供的 std::time_put (类模板) | |
表示命名区域设置的系统提供的 std::numpunct (类模板) | |
表示命名区域设置的系统提供的 std::moneypunct (类模板) | |
函数 | |
区域设置和构面 | |
从区域设置中获取构面 (函数模板) | |
检查区域设置是否实现了特定构面 (函数模板) | |
字符分类 | |
检查字符是否被区域设置归类为空格 (函数模板) | |
(C++11) |
检查字符是否被区域设置归类为空格字符 (函数模板) |
检查字符是否被区域设置归类为控制字符 (函数模板) | |
检查字符是否被区域设置归类为大写 (函数模板) | |
检查字符是否被区域设置归类为小写 (函数模板) | |
检查字符是否被区域设置归类为字母 (函数模板) | |
检查字符是否被区域设置归类为数字 (函数模板) | |
检查字符是否被区域设置归类为标点符号 (函数模板) | |
检查字符是否被区域设置归类为十六进制数字 (函数模板) | |
检查字符是否被区域设置归类为字母数字 (函数模板) | |
检查字符是否被区域设置归类为可打印字符 (函数模板) | |
检查字符是否被区域设置归类为图形字符 (函数模板) | |
字符转换 | |
使用区域设置的 ctype 面使用字符转换为大写 (函数模板) | |
使用区域设置的 ctype 面使用字符转换为小写(函数模板) |
[编辑] 概要
namespace std { // locale: class locale; template <class Facet> const Facet& use_facet(const locale&); template <class Facet> bool has_facet(const locale&) noexcept; // convenience interfaces: template <class CharT> bool isspace (CharT c, const locale& loc); template <class CharT> bool isprint (CharT c, const locale& loc); template <class CharT> bool iscntrl (CharT c, const locale& loc); template <class CharT> bool isupper (CharT c, const locale& loc); template <class CharT> bool islower (CharT c, const locale& loc); template <class CharT> bool isalpha (CharT c, const locale& loc); template <class CharT> bool isdigit (CharT c, const locale& loc); template <class CharT> bool ispunct (CharT c, const locale& loc); template <class CharT> bool isxdigit(CharT c, const locale& loc); template <class CharT> bool isalnum (CharT c, const locale& loc); template <class CharT> bool isgraph (CharT c, const locale& loc); template <class CharT> CharT toupper(CharT c, const locale& loc); template <class CharT> CharT tolower(CharT c, const locale& loc); template <class Codecvt, class Elem = wchar_t, class Wide_alloc = std::allocator<Elem>, class Byte_alloc = std::allocator<char>> class wstring_convert; template <class Codecvt, class Elem = wchar_t, class Tr = char_traits<Elem>> class wbuffer_convert; // ctype: class ctype_base; template <class CharT> class ctype; template <> class ctype<char>; // specialization template <class CharT> class ctype_byname; class codecvt_base; template <class internT, class externT, class stateT> class codecvt; template <class internT, class externT, class stateT> class codecvt_byname; // numeric: template <class CharT, class InputIter = istreambuf_iterator<CharT>> class num_get; template <class CharT, class OutputIter = osterambuf_iterator<CharT>> class num_put; template <class CharT> class numpunct; template <class CharT> class numpunct_byname; // collation: template <class CharT> class collate; template <class CharT> class collate_byname; // date and time: class time_base; template <class CharT, class InputIter = istreambuf_iterator<CharT>> class time_get; template <class CharT, class InputIter> = istreambuf_iterator<CharT>> class time_get_byname; template <class CharT, class OutputIter> = ostreambuf_iterator<CharT>> class time_put; template <class CharT, class OutputIter> = ostreambuf_iterator<CharT>> class time_put_byname; // money: class money_base; template <class CharT, class InputIter = istreambuf_iterator<CharT>> > class money_get; template <class CharT, class OutputIter = ostreambuf_iterator<CharT>> > class money_put; template <class CharT, bool Intl = false> class moneypunct; template <class CharT, bool Intl = false> class moneypunct_byname; // message retrieval: class messages_base; template <class CharT> class messages; template <class CharT> class messages_byname; }
[编辑] 类 std::locale
class locale { public: // types: class facet; class id; typedef int category; static const category // values assigned here are for exposition only none = 0, collate = 0x010, ctype = 0x020, monetary = 0x040, numeric = 0x080, time = 0x100, messages = 0x200, all = collate | ctype | monetary | numeric | time | messages; // construct/copy/destroy: locale() noexcept; locale(const locale& other) noexcept; explicit locale(const char* std_name); explicit locale(const string& std_name); locale(const locale& other, const char* std_name, category); locale(const locale& other, const string& std_name, category); template <class Facet> locale(const locale& other, Facet* f); locale(const locale& other, const locale& one, category); ~locale(); // not virtual const locale& operator=(const locale& other) noexcept; template <class Facet> locale combine(const locale& other) const; // locale operations: basic_string<char> name() const; bool operator==(const locale& other) const; bool operator!=(const locale& other) const; template <class CharT, class Traits, class Allocator> bool operator()(const basic_string<CharT,Traits,Allocator>& s1, const basic_string<CharT,Traits,Allocator>& s2) const; // global locale objects: static locale global(const locale&); static const locale& classic(); };
[编辑] 类 std::ctype_base
class ctype_base { public: typedef /*bitmask-type*/ mask; // numeric values are for exposition only. static const mask space = 1 << 0; static const mask print = 1 << 1; static const mask cntrl = 1 << 2; static const mask upper = 1 << 3; static const mask lower = 1 << 4; static const mask alpha = 1 << 5; static const mask digit = 1 << 6; static const mask punct = 1 << 7; static const mask xdigit= 1 << 8; static const mask blank = 1 << 9; static const mask alnum = alpha | digit; static const mask graph = alnum | punct; };
[编辑] 类 std::ctype
template <class CharT> class ctype : public locale::facet, public ctype_base { public: typedef CharT char_type; explicit ctype(size_t refs = 0); bool is(mask m, CharT c) const; const CharT* is(const CharT* low, const CharT* high, mask* vec) const; const CharT* scan_is(mask m, const CharT* low, const CharT* high) const; const CharT* scan_not(mask m, const CharT* low, const CharT* high) const; CharT toupper(CharT c) const; const CharT* toupper(CharT* low, const CharT* high) const; CharT tolower(CharT c) const; const CharT* tolower(CharT* low, const CharT* high) const; CharT widen(char c) const; const char* widen(const char* low, const char* high, CharT* to) const; char narrow(CharT c, char dfault) const; const CharT* narrow(const CharT* low, const CharT*, char dfault, char* to) const; static locale::id id; protected: ~ctype(); virtual bool do_is(mask m, CharT c) const; virtual const CharT* do_is(const CharT* low, const CharT* high, mask* vec) const; virtual const CharT* do_scan_is(mask m, const CharT* low, const CharT* high) const; virtual const CharT* do_scan_not(mask m, const CharT* low, const CharT* high) const; virtual CharT do_toupper(CharT) const; virtual const CharT* do_toupper(CharT* low, const CharT* high) const; virtual CharT do_tolower(CharT) const; virtual const CharT* do_tolower(CharT* low, const CharT* high) const; virtual CharT do_widen(char) const; virtual const char* do_widen(const char* low, const char* high, CharT* dest) const; virtual char do_narrow(CharT, char dfault) const; virtual const CharT* do_narrow(const CharT* low, const CharT* high, char dfault, char* dest) const; };
[编辑] 类 std::ctype_byname
template <class CharT> class ctype_byname : public ctype<CharT> { public: typedef typename ctype<CharT>::mask mask; explicit ctype_byname(const char*, size_t refs = 0); explicit ctype_byname(const string&, size_t refs = 0); protected: ~ctype_byname(); };
[编辑] 类 std::ctype<char>
template <> class ctype<char> : public locale::facet, public ctype_base { public: typedef char char_type; explicit ctype(const mask* tab = 0, bool del = false, size_t refs = 0); bool is(mask m, char c) const; const char* is(const char* low, const char* high, mask* vec) const; const char* scan_is (mask m, const char* low, const char* high) const; const char* scan_not(mask m, const char* low, const char* high) const; char toupper(char c) const; const char* toupper(char* low, const char* high) const; char tolower(char c) const; const char* tolower(char* low, const char* high) const; char widen(char c) const; const char* widen(const char* low, const char* high, char* to) const; char narrow(char c, char dfault) const; const char* narrow(const char* low, const char* high, char dfault, char* to) const; static locale::id id; static const size_t table_size = /* implementation-defined */; const mask* table() const noexcept; static const mask* classic_table() noexcept; protected: ~ctype(); virtual char do_toupper(char c) const; virtual const char* do_toupper(char* low, const char* high) const; virtual char do_tolower(char c) const; virtual const char* do_tolower(char* low, const char* high) const; virtual char do_widen(char c) const; virtual const char* do_widen(const char* low, const char* high, char* to) const; virtual char do_narrow(char c, char dfault) const; virtual const char* do_narrow(const char* low, const char* high, char dfault, char* to) const; };
[编辑] 类 std::codecvt_base
class codecvt_base { public: enum result { ok, partial, error, noconv }; };
[编辑] 类 std::codecvt
template <class internT, class externT, class stateT> class codecvt : public locale::facet, public codecvt_base { public: typedef internT intern_type; typedef externT extern_type; typedef stateT state_type; explicit codecvt(size_t refs = 0); result out(stateT& state, const internT* from, const internT* from_end, const internT*& from_next, externT* to, externT* to_end, externT*& to_next) const; result unshift(stateT& state, externT* to, externT* to_end, externT*& to_next) const; result in(stateT& state, const externT* from, const externT* from_end, const externT*& from_next, internT* to, internT* to_end, internT*& to_next) const; int encoding() const noexcept; bool always_noconv() const noexcept; int length(stateT&, const externT* from, const externT* end, size_t max) const; int max_length() const noexcept; static locale::id id; protected: ~codecvt(); virtual result do_out(stateT& state, const internT* from, const internT* from_end, const internT*& from_next, externT* to, externT* to_end, externT*& to_next) const; virtual result do_in(stateT& state, const externT* from, const externT* from_end, const externT*& from_next, internT* to, internT* to_end, internT*& to_next) const; virtual result do_unshift(stateT& state, externT* to, externT* to_end, externT*& to_next) const; virtual int do_encoding() const noexcept; virtual bool do_always_noconv() const noexcept; virtual int do_length(stateT&, const externT* from, const externT* end, size_t max) const; virtual int do_max_length() const noexcept; };
[编辑] 类 std::codecvt_byname
template <class internT, class externT, class stateT> class codecvt_byname : public codecvt<internT, externT, stateT> { public: explicit codecvt_byname(const char*, size_t refs = 0); explicit codecvt_byname(const string&, size_t refs = 0); protected: ~codecvt_byname(); };
[编辑] 类 std::num_get
template <class CharT, class InputIter = istreambuf_iterator<CharT>> class num_get : public locale::facet { public: typedef CharT char_type; typedef InputIter iter_type; explicit num_get(size_t refs = 0); iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, bool& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, long& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, long long& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, unsigned short& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, unsigned int& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, unsigned long& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, unsigned long long& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, float& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, double& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, long double& v) const; iter_type get(iter_type in, iter_type end, ios_base&, ios_base::iostate& err, void*& v) const; static locale::id id; protected: ~num_get(); virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, bool& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, long& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, long long& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, unsigned short& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, unsigned int& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, unsigned long& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, unsigned long long& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, float& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, double& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, long double& v) const; virtual iter_type do_get(iter_type, iter_type, ios_base&, ios_base::iostate& err, void*& v) const; };
[编辑] 类 std::num_put
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>> class num_put : public locale::facet { public: typedef CharT char_type; typedef OutputIter iter_type; explicit num_put(size_t refs = 0); iter_type put(iter_type s, ios_base& f, char_type fill, bool v) const; iter_type put(iter_type s, ios_base& f, char_type fill, long v) const; iter_type put(iter_type s, ios_base& f, char_type fill, long long v) const; iter_type put(iter_type s, ios_base& f, char_type fill, unsigned long v) const; iter_type put(iter_type s, ios_base& f, char_type fill, unsigned long long v) const; iter_type put(iter_type s, ios_base& f, char_type fill, double v) const; iter_type put(iter_type s, ios_base& f, char_type fill, long double v) const; iter_type put(iter_type s, ios_base& f, char_type fill, const void* v) const; static locale::id id; protected: ~num_put(); virtual iter_type do_put(iter_type, ios_base&, char_type fill, bool v) const; virtual iter_type do_put(iter_type, ios_base&, char_type fill, long v) const; virtual iter_type do_put(iter_type, ios_base&, char_type fill, long long v) const; virtual iter_type do_put(iter_type, ios_base&, char_type fill, unsigned long) const; virtual iter_type do_put(iter_type, ios_base&, char_type fill, unsigned long long) const; virtual iter_type do_put(iter_type, ios_base&, char_type fill, double v) const; virtual iter_type do_put(iter_type, ios_base&, char_type fill, long double v) const; virtual iter_type do_put(iter_type, ios_base&, char_type fill, const void* v) const; };
[编辑] 类 std::numpunct
template <class CharT> class numpunct : public locale::facet { public: typedef CharT char_type; typedef basic_string<CharT> string_type; explicit numpunct(size_t refs = 0); char_type decimal_point() const; char_type thousands_sep() const; string grouping() const; string_type truename() const; string_type falsename() const; static locale::id id; protected: ~numpunct(); // virtual virtual char_type do_decimal_point() const; virtual char_type do_thousands_sep() const; virtual string do_grouping() const; virtual string_type do_truename() const; // for bool virtual string_type do_falsename() const; // for bool };
[编辑] 类 std::numpunct_byname
template <class CharT> class numpunct_byname : public numpunct<CharT> { public: typedef CharT char_type; typedef basic_string<CharT> string_type; explicit numpunct_byname(const char*, size_t refs = 0); explicit numpunct_byname(const string&, size_t refs = 0); protected: ~numpunct_byname(); };
[编辑] 类 std::collate
template <class CharT> class collate : public locale::facet { public: typedef CharT char_type; typedef basic_string<CharT> string_type; explicit collate(size_t refs = 0); int compare(const CharT* low1, const CharT* high1, const CharT* low2, const CharT* high2) const; string_type transform(const CharT* low, const CharT* high) const; long hash(const CharT* low, const CharT* high) const; static locale::id id; protected: ~collate(); virtual int do_compare(const CharT* low1, const CharT* high1, const CharT* low2, const CharT* high2) const; virtual string_type do_transform(const CharT* low, const CharT* high) const; virtual long do_hash (const CharT* low, const CharT* high) const; };
[编辑] 类 std::collate_byname
template <class CharT> class collate_byname : public collate<CharT> { public: typedef basic_string<CharT> string_type; explicit collate_byname(const char*, size_t refs = 0); explicit collate_byname(const string&, size_t refs = 0); protected: ~collate_byname(); };
[编辑] 类 std::time_base
class time_base { public: enum dateorder { no_order, dmy, mdy, ymd, ydm }; };
[编辑] 类 std::time_get
template <class CharT, class InputIter = istreambuf_iterator<CharT>> class time_get : public locale::facet, public time_base { public: typedef CharT char_type; typedef InputIter iter_type; explicit time_get(size_t refs = 0); dateorder date_order() const; iter_type get_time(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err, tm* t) const; iter_type get_date(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err, tm* t) const; iter_type get_weekday(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err, tm* t) const; iter_type get_monthname(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err, tm* t) const; iter_type get_year(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err, tm* t) const; iter_type get(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err, tm* t, char format, char modifier = 0) const; iter_type get(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err, tm* t, const char_type* fmt, const char_type* fmtend) const; static locale::id id; protected: ~time_get(); virtual dateorder do_date_order() const; virtual iter_type do_get_time(iter_type s, iter_type end, ios_base&, ios_base::iostate& err, tm* t) const; virtual iter_type do_get_date(iter_type s, iter_type end, ios_base&, ios_base::iostate& err, tm* t) const; virtual iter_type do_get_weekday(iter_type s, iter_type end, ios_base&, ios_base::iostate& err, tm* t) const; virtual iter_type do_get_monthname(iter_type s, iter_type end, ios_base&, ios_base::iostate& err, tm* t) const; virtual iter_type do_get_year(iter_type s, iter_type end, ios_base&, ios_base::iostate& err, tm* t) const; virtual iter_type do_get(iter_type s, iter_type end, ios_base& f, ios_base::iostate& err, tm* t, char format, char modifier) const; };
[编辑] 类 std::time_get_byname
template <class CharT, class InputIter = istreambuf_iterator<CharT>> class time_get_byname : public time_get<CharT, InputIter> { public: typedef time_base::dateorder dateorder; typedef InputIter iter_type; explicit time_get_byname(const char*, size_t refs = 0); explicit time_get_byname(const string&, size_t refs = 0); protected: ~time_get_byname(); };
[编辑] 类 std::time_put
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>> class time_put : public locale::facet { public: typedef CharT char_type; typedef OutputIter iter_type; explicit time_put(size_t refs = 0); // the following is implemented in terms of other member functions. iter_type put(iter_type s, ios_base& f, char_type fill, const tm* tmb, const CharT* pattern, const CharT* pat_end) const; iter_type put(iter_type s, ios_base& f, char_type fill, const tm* tmb, char format, char modifier = 0) const; static locale::id id; protected: ~time_put(); virtual iter_type do_put(iter_type s, ios_base&, char_type, const tm* t, char format, char modifier) const; };
[编辑] 类 std::time_put_byname
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>> class time_put_byname : public time_put<CharT, OutputIter> { public: typedef CharT char_type; typedef OutputIter iter_type; explicit time_put_byname(const char*, size_t refs = 0); explicit time_put_byname(const string&, size_t refs = 0); protected: ~time_put_byname(); };
[编辑] 类 std::money_get
template <class CharT, class InputIter = istreambuf_iterator<CharT>> class money_get : public locale::facet { public: typedef CharT char_type; typedef InputIter iter_type; typedef basic_string<CharT> string_type; explicit money_get(size_t refs = 0); iter_type get(iter_type s, iter_type end, bool intl, ios_base& f, ios_base::iostate& err, long double& units) const; iter_type get(iter_type s, iter_type end, bool intl, ios_base& f, ios_base::iostate& err, string_type& digits) const; static locale::id id; protected: ~money_get(); virtual iter_type do_get(iter_type, iter_type, bool, ios_base&, ios_base::iostate& err, long double& units) const; virtual iter_type do_get(iter_type, iter_type, bool, ios_base&, ios_base::iostate& err, string_type& digits) const; };
[编辑] 类 std::money_put
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>> class money_put : public locale::facet { public: typedef CharT char_type; typedef OutputIter iter_type; typedef basic_string<CharT> string_type; explicit money_put(size_t refs = 0); iter_type put(iter_type s, bool intl, ios_base& f, char_type fill, long double units) const; iter_type put(iter_type s, bool intl, ios_base& f, char_type fill, const string_type& digits) const; static locale::id id; protected: ~money_put(); virtual iter_type do_put(iter_type, bool, ios_base&, char_type fill, long double units) const; virtual iter_type do_put(iter_type, bool, ios_base&, char_type fill, const string_type& digits) const; };
[编辑] 类 std::money_base
class money_base { public: enum part { none, space, symbol, sign, value }; struct pattern { char field[4]; }; };
[编辑] 类 std::moneypunct
template <class CharT, bool International = false> class moneypunct : public locale::facet, public money_base { public: typedef CharT char_type; typedef basic_string<CharT> string_type; explicit moneypunct(size_t refs = 0); CharT decimal_point() const; CharT thousands_sep() const; string grouping() const; string_type curr_symbol() const; string_type positive_sign() const; string_type negative_sign() const; int frac_digits() const; pattern pos_format() const; pattern neg_format() const; static locale::id id; static const bool intl = International; protected: ~moneypunct(); virtual CharT do_decimal_point() const; virtual CharT do_thousands_sep() const; virtual string do_grouping() const; virtual string_type do_curr_symbol() const; virtual string_type do_positive_sign() const; virtual string_type do_negative_sign() const; virtual int do_frac_digits() const; virtual pattern do_pos_format() const; virtual pattern do_neg_format() const; };
[编辑] 类 std::moneypunct_byname
template <class CharT, bool Intl = false> class moneypunct_byname : public moneypunct<CharT, Intl> { public: typedef money_base::pattern pattern; typedef basic_string<CharT> string_type; explicit moneypunct_byname(const char*, size_t refs = 0); explicit moneypunct_byname(const string&, size_t refs = 0); protected: ~moneypunct_byname(); };
[编辑] 类 std::messages_base
class messages_base { public: typedef /* unspecified signed integer type */ catalog; };
[编辑] 类 std::messages
template <class CharT> class messages : public locale::facet, public messages_base { public: typedef CharT char_type; typedef basic_string<CharT> string_type; explicit messages(size_t refs = 0); catalog open(const basic_string<char>& fn, const locale&) const; string_type get(catalog c, int set, int msgid, const string_type& dfault) const; void close(catalog c) const; static locale::id id; protected: ~messages(); virtual catalog do_open(const basic_string<char>&, const locale&) const; virtual string_type do_get(catalog, int set, int msgid, const string_type& dfault) const; virtual void do_close(catalog) const; };
[编辑] 类 std::messages_byname
template <class CharT> class messages_byname : public messages<CharT> { public: typedef messages_base::catalog catalog; typedef basic_string<CharT> string_type; explicit messages_byname(const char*, size_t refs = 0); explicit messages_byname(const string&, size_t refs = 0); protected: ~messages_byname(); };
[编辑] 类 std::wstring_convert
template<class Codecvt, class Elem = wchar_t, class Wide_alloc = std::allocator<Elem>, class Byte_alloc = std::allocator<char>> class wstring_convert { public: typedef std::basic_string<char, char_traits<char>, Byte_alloc> byte_string; typedef std::basic_string<Elem, char_traits<Elem>, Wide_alloc> wide_string; typedef typename Codecvt::state_type state_type; typedef typename wide_string::traits_type::int_type int_type; explicit wstring_convert(Codecvt* pcvt = new Codecvt); wstring_convert(Codecvt* pcvt, state_type state); explicit wstring_convert(const byte_string& byte_err, const wide_string& wide_err = wide_string()); ~wstring_convert(); wstring_convert(const wstring_convert&) = delete; wstring_convert& operator=(const wstring_convert&) = delete; wide_string from_bytes(char byte); wide_string from_bytes(const char* ptr); wide_string from_bytes(const byte_string& str); wide_string from_bytes(const char* first, const char* last); byte_string to_bytes(Elem wchar); byte_string to_bytes(const Elem* wptr); byte_string to_bytes(const wide_string& wstr); byte_string to_bytes(const Elem* first, const Elem* last); size_t converted() const noexcept; state_type state() const; private: byte_string byte_err_string; // exposition only wide_string wide_err_string; // exposition only Codecvt* cvtptr; // exposition only state_type cvtstate; // exposition only size_t cvtcount; // exposition only };
[编辑] 类 std::wbuffer_convert
template<class Codecvt, class Elem = wchar_t, class Tr = std::char_traits<Elem>> class wbuffer_convert : public std::basic_streambuf<Elem, Tr> { public: typedef typename Codecvt::state_type state_type; explicit wbuffer_convert(std::streambuf* bytebuf = 0, Codecvt* pcvt = new Codecvt, state_type state = state_type()); ~wbuffer_convert(); wbuffer_convert(const wbuffer_convert&) = delete; wbuffer_convert& operator=(const wbuffer_convert&) = delete; std::streambuf* rdbuf() const; std::streambuf* rdbuf(std::streambuf* bytebuf); state_type state() const; private: std::streambuf* bufptr; // exposition only Codecvt* cvtptr; // exposition only state_type cvtstate; // exposition only };
[编辑] 缺陷报告
以下行为更改缺陷报告被追溯应用于先前发布的 C++ 标准。
DR | 应用于 | 已发布的行为 | 正确行为 |
---|---|---|---|
LWG 71 | C++98 | 参数 end 的 time_get::do_get_monthname 在概要中缺失 |
已添加 |
LWG 75 | C++98 | 成员 length 和 do_length 的参数 state 的类型在概要中 codecvt 和 codecvt_byname 为 const stateT& |
更正为 stateT& |
LWG 124 | C++98 | 成员 do_scan_is 和 do_scan_not 的返回值类型在概要中 codecvt_byname 为 const char* |
更正为 const charT* |
LWG 228 | C++98 | XXX_byname 的所有虚成员函数都在概要中列出 |
只列出析构函数 (删除所有其他 虚成员函数) |
LWG 268 | C++98 | 默认构造函数的声明后的分号 和 std::locale 的复制构造函数在概要中丢失 |
已添加 |
LWG 1298 | C++98 | 有一个显式特化 ctype_byname<char> 在概要中 |
已移除 |