std::iscntrl

来自cppreference.com
< cpp‎ | string‎ | byte
定义于头文件 <cctype>
int iscntrl( int ch );

检查给定的字符是否为当前安装的 C 本地环境分类为控制字符。默认的 "C" 本地环境中。控制字符是拥有编码 0x00-0x1F0x7F 的字符。

ch 的值不可表示为 unsigned char 且不等于 EOF 则行为未定义。

目录

[编辑] 参数

ch - 要分类的字符

[编辑] 返回值

若字符为控制字符则为非零值,否则为零。

[编辑] 注意

同所有其他来自 <cctype> 的函数,若参数值既不能表示为 unsigned char 又不等于 EOFstd::iscntrl 的行为未定义。为了以简单的 char (或 signed char )安全使用此函数,首先要将参数转换为 unsigned char

bool my_iscntrl(char ch)
{
    return std::iscntrl(static_cast<unsigned char>(ch));
}

类似地,迭代器的值类型为 charsigned char 时,不应直接将它们用于标准算法。而是要首先转换值为 unsigned char

int count_cntrls(const std::string& s)
{
    return std::count_if(s.begin(), s.end(), 
                      // static_cast<int(*)(int)>(std::iscntrl)         // 错误
                      // [](int c){ return std::iscntrl(c); }           // 错误
                      // [](char c){ return std::iscntrl(c); }          // 错误
                         [](unsigned char c){ return std::iscntrl(c); } // 正确
                        );
}

[编辑] 示例

#include <iostream>
#include <cctype>
#include <clocale>
 
int main()
{
    unsigned char c = '\x94'; // ISO-8859-1 中的控制码 CCH
 
    std::cout << "iscntrl(\'\\x94\', default C locale) returned "
               << std::boolalpha << (bool)std::iscntrl(c) << '\n';
 
    std::setlocale(LC_ALL, "en_GB.iso88591");
    std::cout << "iscntrl(\'\\x94\', ISO-8859-1 locale) returned "
              << std::boolalpha << (bool)std::iscntrl(c) << '\n';
 
}

输出:

iscntrl('\x94', default C locale) returned false
iscntrl('\x94', ISO-8859-1 locale) returned true


[编辑] 参阅

检查字符是否被本地环境分类为控制字符
(函数模板) [编辑]
检查宽字符是否为控制字符
(函数) [编辑]
iscntrlC 文档
ASCII 值
(十六进制)
字符

iscntrl
iswcntrl

isprint
iswprint

isspace
iswspace

isblank
iswblank

isgraph
iswgraph

ispunct
iswpunct

isalnum
iswalnum

isalpha
iswalpha

isupper
iswupper

islower
iswlower

isdigit
iswdigit

isxdigit
iswxdigit

0 - 8 0x00-0x08 控制码 (NUL 等) ≠0 0 0 0 0 0 0 0 0 0 0 0
9 0x09 制表符 (\t) ≠0 0 ≠0 ≠0 0 0 0 0 0 0 0 0
10 - 13 0x0A-0x0D 空白字符 (\n,\v,\f,\r) ≠0 0 ≠0 0 0 0 0 0 0 0 0 0
14 - 31 0x0E-0x1F 控制码 ≠0 0 0 0 0 0 0 0 0 0 0 0
32 0x20 空格 0 ≠0 ≠0 ≠0 0 0 0 0 0 0 0 0
33 - 47 0x21-0x2F !"#$%&'()*+,-./ 0 ≠0 0 0 ≠0 ≠0 0 0 0 0 0 0
48 - 57 0x30-0x39 0123456789 0 ≠0 0 0 ≠0 0 ≠0 0 0 0 ≠0 ≠0
58 - 64 0x3a-0x40 :;<=>?@ 0 ≠0 0 0 ≠0 ≠0 0 0 0 0 0 0
65 - 70 0x41-0x46 ABCDEF 0 ≠0 0 0 ≠0 0 ≠0 ≠0 ≠0 0 0 ≠0
71 - 90 0x47-0x5A GHIJKLMNOPQRSTUVWXYZ 0 ≠0 0 0 ≠0 0 ≠0 ≠0 ≠0 0 0 0
91 - 96 0x5B-0x60 [\]^_` 0 ≠0 0 0 ≠0 ≠0 0 0 0 0 0 0
97 -102 0x61-0x66 abcdef 0 ≠0 0 0 ≠0 0 ≠0 ≠0 0 ≠0 0 ≠0
103-122 0x67-0x7A ghijklmnopqrstuvwxyz 0 ≠0 0 0 ≠0 0 ≠0 ≠0 0 ≠0 0 0
123-126 0x7B-0x7E {|}~ 0 ≠0 0 0 ≠0 ≠0 0 0 0 0 0 0
127 0x7F 退格字符 (DEL) ≠0 0 0 0 0 0 0 0 0 0 0 0