std::iscntrl
Определён в заголовочном файле <cctype> | ||
|---|---|---|
int iscntrl( int ch ); |
Проверяет, является ли указанный символ управляющим символом согласно классификации текущей локали C. В локали по умолчанию "C" управляющими символами являются символы с кодами 0x00-0x1F и 0x7F.
Поведение не определено, если значение ch не представимо типом unsignedchar и не равно EOF.
Параметры
| ch | - | символ для классификации |
Возвращаемое значение
Ненулевое значение, если символ является управляющим; в противном случае — ноль.
Примечания
Как и для всех остальных функций из <cctype>, поведение std::iscntrl не определено, если значение аргумента не представимо типом unsignedchar и не равно EOF. Чтобы безопасно использовать эти функции с обычными символами char (или символами signedchar), аргумент сначала следует преобразовать к типу unsignedchar:
bool my_iscntrl(char ch)
{
return std::iscntrl(static_cast<unsigned char>(ch));
}
Аналогично, их не следует напрямую использовать со стандартными алгоритмами, если тип значения итератора — char или signedchar. Сначала преобразуйте значение к типу unsignedchar:
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 | символы | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| десятичная | шестнадцатеричная | восьмеричная | |||||||||||||
| 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/cpp/string/byte/iscntrl