std::iscntrl
Определено в заголовке <cctype> | ||
|---|---|---|
int iscntrl( int ch ); |
Проверяет, является ли заданный символ управляющим символом, согласно текущему локали C. В стандартной "C" локали управляющие символы — это символы с кодами 0x00-0x1F и 0x7F.
Поведение не определено, если значение ch не может быть представлено как unsigned char и не равно EOF.
Параметры
| ch | - | символ для классификации |
Возвращаемое значение
Неноль, если символ является управляющим символом; ноль в противном случае.
Примечания
Как и все остальные функции из <cctype>, поведение std::iscntrl не определено, если значение аргумента не может быть представлено как unsigned char и не равно EOF. Чтобы безопасно использовать эти функции с обычными char (или signed char), аргумент следует сначала преобразовать в unsigned char:
bool my_iscntrl(char ch)
{
return std::iscntrl(static_cast<unsigned char>(ch));
}Аналогично, их не следует напрямую использовать со стандартными алгоритмами, когда тип значения итератора — char или signed char. Вместо этого значение следует предварительно преобразовать в unsigned char:
int count_cntrls(const std::string& s)
{
return std::count_if(s.begin(), s.end(),
// static_cast<int(*)(int)>(std::iscntrl) // wrong
// [](int c){ return std::iscntrl(c); } // wrong
// [](char c){ return std::iscntrl(c); } // wrong
[](unsigned char c){ return std::iscntrl(c); } // correct
);
}Пример
#include <cctype>
#include <clocale>
#include <iostream>
int main()
{
unsigned char c = '\x94'; // the control code CCH in ISO-8859-1
std::cout << "iscntrl(\'\\x94\', default C locale) returned "
<< std::boolalpha << !!std::iscntrl(c) << '\n';
std::setlocale(LC_ALL, "en_GB.iso88591");
std::cout << "iscntrl(\'\\x94\', ISO-8859-1 locale) returned "
<< !!std::iscntrl(c) << '\n';
}Возможный вывод:
iscntrl('\x94', default C locale) returned false
iscntrl('\x94', ISO-8859-1 locale) returned trueСм. также
| проверяет, классифицируется ли символ как управляющий с помощью локали (функция-шаблон) |
|
| проверяет, является ли широкий символ управляющим символом (функция) |
|
C документация для iscntrl |
|
| ASCII values | символы |
| |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| десятичное | шестнадцатеричное | восьмеричное | |||||||||||||
| 0–8 |
\x0–\x8 |
\0–\10 | коды управления (NUL, и т. д.) |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 9 |
\x9 |
\11 | табуляция (\t) |
≠0 | 0 |
≠0 |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 10–13 |
\xA–\xD |
\12–\15 | пробелы (\n, \v, \f, \r) |
≠0 | 0 |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 14–31 |
\xE–\x1F |
\16–\37 | коды управления |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 32 |
\x20 |
\40 | пробел | 0 |
≠0 |
≠0 |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 33–47 |
\x21–\x2F |
\41–\57 |
!"#$%&'()*+,-./ | 0 |
≠0 | 0 | 0 |
≠0 |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 48–57 |
\x30–\x39 |
\60–\71 |
0123456789 | 0 |
≠0 | 0 | 0 |
≠0 | 0 |
≠0 | 0 | 0 | 0 |
≠0 |
≠0 |
| 58–64 |
\x3A–\x40 |
\72–\100 |
:;<=>?@ | 0 |
≠0 | 0 | 0 |
≠0 |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 65–70 |
\x41–\x46 |
\101–\106 |
ABCDEF | 0 |
≠0 | 0 | 0 |
≠0 | 0 |
≠0 |
≠0 |
≠0 | 0 | 0 |
≠0 |
| 71–90 |
\x47–\x5A |
\107–\132 |
GHIJKLMNOPQRSTUVWXYZ | 0 |
≠0 | 0 | 0 |
≠0 | 0 |
≠0 |
≠0 |
≠0 | 0 | 0 | 0 |
| 91–96 |
\x5B–\x60 |
\133–\140 |
[\]^_` | 0 |
≠0 | 0 | 0 |
≠0 |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 97–102 |
\x61–\x66 |
\141–\146 |
abcdef | 0 |
≠0 | 0 | 0 |
≠0 | 0 |
≠0 |
≠0 | 0 |
≠0 | 0 |
≠0 |
| 103–122 |
\x67–\x7A |
\147–\172 |
ghijklmnopqrstuvwxyz | 0 |
≠0 | 0 | 0 |
≠0 | 0 |
≠0 |
≠0 | 0 |
≠0 | 0 | 0 |
| 123–126 |
\x7B–\x7E |
\172–\176 |
{|}~ | 0 |
≠0 | 0 | 0 |
≠0 |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 127 |
\x7F |
\177 | знак возврата (DEL) |
≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/byte/iscntrl