std::ctype<char>

定义于头文件 `<locale>`
template<> class ctype<char>;

这个 std::ctype 的特化为 char 类型封装了字符分类特性。与使用虚函数的一般用途的 std::ctype 不同，此特化使用表格查找来分类字符（通常更快）。

基类 std::ctype<char> 实现了与最小“C”区域设置等效的字符分类。如果使用非默认分类表参数构造，或者构造为 std::ctype_byname<char> 或用户定义的派生 facet，则分类规则可以扩展或修改。所有 std::istream 格式化输入函数都必须在输入解析期间使用 std::ctype<char> 进行字符分类。

继承图

(构造函数)	构造一个新的 ctype<char> facet (public member function) [编辑]
(析构函数)	销毁一个 ctype<char> facet (protected member function) [编辑]
table	获取字符分类表 (public member function) [编辑]
classic_table [静态]	获取“C”区域设置字符分类表 (public static member function) [编辑]
is	使用分类表对字符或字符序列进行分类 (public member function) [编辑]
scan_is	使用分类表在序列中定位第一个符合给定分类的字符 (public member function) [编辑]
scan_not	使用分类表在序列中定位第一个不符合给定分类的字符 (public member function) [编辑]
toupper	调用 `do_toupper` (`std::ctype<CharT>` 的公共成员函数) [编辑]
tolower	调用 `do_tolower` (`std::ctype<CharT>` 的公共成员函数) [编辑]
widen	调用 `do_widen` (`std::ctype<CharT>` 的公共成员函数) [编辑]
narrow	调用 `do_narrow` (`std::ctype<CharT>` 的公共成员函数) [编辑]

[编辑] 保护成员函数

do_toupper [virtual]	将一个或多个字符转换为大写 (`std::ctype<CharT>` 的虚保护成员函数) [编辑]
do_tolower [virtual]	将一个或多个字符转换为小写 (`std::ctype<CharT>` 的虚保护成员函数) [编辑]
do_widen [virtual]	将一个或多个字符从 char 转换为 `CharT` (`std::ctype<CharT>` 的虚保护成员函数) [编辑]
do_narrow [virtual]	将一个或多个字符从 `CharT` 转换为 char (`std::ctype<CharT>` 的虚保护成员函数) [编辑]

继承自 std::ctype_base

嵌套类型

类型	定义
`mask`	未指定的 BitmaskType 类型（枚举、整数类型或位集）

成员常量

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

[编辑] 示例

以下示例演示了修改 ctype<char> 以分词逗号分隔的值

运行此代码

#include <cstddef>
#include <iostream>
#include <locale>
#include <sstream>
#include <vector>
 
// This ctype facet classifies commas and endlines as whitespace
struct csv_whitespace : std::ctype<char>
{
    static const mask* make_table()
    {
        // make a copy of the "C" locale table
        static std::vector<mask> v(classic_table(), classic_table() + table_size);
        v[','] |=  space; // comma will be classified as whitespace
        v[' '] &= ~space; // space will not be classified as whitespace
        return &v[0];
    }
 
    csv_whitespace(std::size_t refs = 0) : ctype(make_table(), false, refs) {}
};
 
int main()
{
    std::string in = "Column 1,Column 2,Column 3\n123,456,789";
    std::string token;
 
    std::cout << "Default locale:\n";
    std::istringstream s1(in);
    while (s1 >> token)
        std::cout << "  " << token << '\n';
 
    std::cout << "Locale with modified ctype:\n";
    std::istringstream s2(in);
    s2.imbue(std::locale(s2.getloc(), new csv_whitespace));
    while (s2 >> token)
        std::cout << "  " << token << '\n';
}

输出

Default locale:
  Column
  1,Column
  2,Column
  3
  123,456,789
Locale with modified ctype:
  Column 1
  Column 2
  Column 3
  123
  456
  789

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	发布时的行为	正确的行为
LWG 695	C++98	`table()` 和 `classic_table()` 是保护成员函数	使它们成为公共的

[编辑] 参阅

ctype	定义字符分类表 (类模板) [编辑]
ctype_base	定义字符分类类别 (类) [编辑]
ctype_byname	表示命名区域设置的系统提供的 std::ctype (类模板) [编辑]

编译器支持
自由（freestanding）与宿主（hosted）
语言
标准库
标准库头文件
具名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

成员	描述
std::locale::id `id` [static]	facet 的标识符
const std::size_t `table_size` [static]	分类表的大小，至少 256

cppreference.cn

命名空间

变体

视图

操作