std::ctype_byname

来自cppreference.com
< cpp‎ | locale
定义于头文件 <locale>
template< class CharT >
class ctype_byname : public std::ctype<CharT>;

std::ctype_byname 是封装指定于其构造的本地环境的字符分类规则的 std::ctype 平面。

标准库提供二个特化

定义于头文件 <locale>
std::ctype_byname<char> 提供窄字符分类。此分类用表格查找字符分类
std::ctype_byname<wchar_t> 提供宽字符分类

成员类型

 
成员类型 定义
mask ctype<CharT>::mask

成员函数

(构造函数)
构造新的 ctype_byname 平面
(公开成员函数)
(析构函数)
析构 ctype_byname 平面
(受保护成员函数)

std::ctype_byname::ctype_byname

explicit ctype_byname( const char* name, std::size_t refs = 0 );
explicit ctype_byname( const std::string& name, std::size_t refs = 0 );
(C++11 起)

为名为 name 的本地环境构造新的 std::ctype_byname 平面。

refs 用于资源管理:在销毁最后一个保有平面的 std::locale 对象时,若 refs == 0 ,则实现销毁平面对象。否则,不销毁对象。

参数

name - 本地环境的名称
refs - 链接到该平面的引用数

std::ctype_byname::~ctype_byname

protected:
~ctype_byname();

销毁平面。

继承自 std::ctype<CharT>

成员类型

 
成员类型 定义
char_type CharT

成员对象

 
成员名 类型
static std::locale::id id
[静态]
本地环境的 id
(公开静态成员常量)
CharTchar ,则继承 std::ctype<char> 的下列成员
static const std::size_t table_size
[静态]
分类表的大小,至少为 256
(公开静态成员常量)

成员函数

调用 do_is
(std::ctype<CharT> 的公开成员函数)
调用 do_scan_is
(std::ctype<CharT> 的公开成员函数)
调用 do_scan_not
(std::ctype<CharT> 的公开成员函数)
调用 do_toupper
(std::ctype<CharT> 的公开成员函数)
调用 do_tolower
(std::ctype<CharT> 的公开成员函数)
调用 do_widen
(std::ctype<CharT> 的公开成员函数)
调用 do_narrow
(std::ctype<CharT> 的公开成员函数)
CharTchar ,则继承 std::ctype<char> 的下列成员
获得字符分类表
(std::ctype<char> 的公开成员函数)
获得 "C" 本地环境字符分类表
(std::ctype<char> 的公开静态成员函数)

受保护成员函数

转换一个或多个字符为大写
(std::ctype<CharT> 的虚受保护成员函数)
转换一个或多个字符为小写
(std::ctype<CharT> 的虚受保护成员函数)
将一或多个字符从 char 转换为 charT
(std::ctype<CharT> 的虚受保护成员函数)
将一个或多个字符从 charT 转换为 char
(std::ctype<CharT> 的虚受保护成员函数)
CharTchar ,则不继承 std::ctype 的下列成员
[虚]
分类字符或字符序列
(std::ctype<CharT> 的虚受保护成员函数)
定位序列中首个符合给定分类的字符
(std::ctype<CharT> 的虚受保护成员函数)
定位序列中首个不符合给定分类的字符
(std::ctype<CharT> 的虚受保护成员函数)

继承自 std::ctype_base

成员类型

 
类型 定义
mask 未指定的位掩码类型(枚举、整数类型或 bitset )

成员常量

space
[静态]
鉴别空白字符分类的 mask
(公开静态成员常量)
print
[静态]
鉴别可打印字符分类的 mask
(公开静态成员常量)
cntrl
[静态]
鉴别控制字符分类的 mask
(公开静态成员常量)
upper
[静态]
鉴别大写字符分类的 mask
(公开静态成员常量)
lower
[静态]
鉴别小写字符分类的 mask
(公开静态成员常量)
alpha
[静态]
鉴别字母字符分类的 mask
(公开静态成员常量)
digit
[静态]
鉴别数字字符分类的 mask
(公开静态成员常量)
punct
[静态]
鉴别标点字符分类的 mask
(公开静态成员常量)
xdigit
[静态]
鉴别十六进制数字字符分类的 mask
(公开静态成员常量)
blank
[静态] (C++11)
鉴别空格字符分类的 mask
(公开静态成员常量)
alnum
[静态]
alpha | digit
(公开静态成员常量)
graph
[静态]
alnum | punct
(公开静态成员常量)

注意

C++11 前显式特化 std::ctype_byname<char> 作为单独入口列于头文件 <locale> 。 C++11 中因为缺陷 #1298 被移除,但它仍是被要求的特化,只是像 std::ctype_byname<wchar_t> 一般。

示例

#include <iostream>
#include <locale>
 
int main()
{
    wchar_t c = L'\u00de'; // 大写字母 thorn
 
    std::locale loc("C");
 
    std::cout << "isupper('Þ', C locale) returned "
               << std::boolalpha << std::isupper(c, loc) << '\n';
 
    loc = std::locale(loc, new std::ctype_byname<wchar_t>("en_US.utf8"));
 
    std::cout << "isupper('Þ', C locale with Unicode ctype) returned "
              << std::boolalpha << std::isupper(c, loc) << '\n';
}

输出:

isupper('Þ', C locale) returned false
isupper('Þ', C locale with Unicode ctype) returned true

参阅

定义字符分类表
(类模板)
std::ctype 对于 char 类型的特化
(类模板特化)