Spec-Zone.ru › C++

std::isprint

Определено в заголовочном файле <cctype>
int isprint( int ch );

Проверяет, является ли ch печатным символом, согласно текущему локали C. В стандартной локали "C", следующие символы являются печатными:

  • цифры (0123456789)
  • заглавные буквы (ABCDEFGHIJKLMNOPQRSTUVWXYZ)
  • строчные буквы (abcdefghijklmnopqrstuvwxyz)
  • знаки препинания (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)
  • пробел ()

Поведение не определено, если значение ch не представимо как unsigned char и не равно EOF.

Параметры

ch - символ для классификации

Возвращаемое значение

Неноль, если символ печатный, ноль в противном случае.

Примечания

Как и все остальные функции из <cctype>, поведение std::isprint не определено, если значение аргумента не представимо как unsigned char и не равно EOF. Чтобы безопасно использовать эти функции с обычными char (или signed char), аргумент следует сначала преобразовать в unsigned char.

bool my_isprint(char ch)
{
    return std::isprint(static_cast<unsigned char>(ch));
}

Аналогично, их не следует напрямую использовать со стандартными алгоритмами, когда тип значения итератора - char или signed char. Вместо этого значение следует сначала преобразовать в unsigned char.

int count_prints(const std::string& s)
{
    return std::count_if(s.begin(), s.end(), 
                      // static_cast<int(*)(int)>(std::isprint)         // wrong
                      // [](int c){ return std::isprint(c); }           // wrong
                      // [](char c){ return std::isprint(c); }          // wrong
                         [](unsigned char c){ return std::isprint(c); } // correct
                        );
}

Пример

#include <cctype>
#include <clocale>
#include <iostream>
 
int main()
{
    unsigned char c = '\xa0'; // the non-breaking space in ISO-8859-1
 
    std::cout << "isprint(\'\\xa0\', default C locale) returned "
              << std::boolalpha << (bool)std::isprint(c) << '\n';
 
    std::setlocale(LC_ALL, "en_GB.iso88591");
    std::cout << "isprint(\'\\xa0\', ISO-8859-1 locale) returned "
              << std::boolalpha << (bool)std::isprint(c) << '\n';
}

Возможный вывод:

isprint('\xa0', default C locale) returned false
isprint('\xa0', ISO-8859-1 locale) returned true

См. также

isprint(std::locale)
проверяет, является ли символ печатным с точки зрения локали
(шаблон функции)
iswprint
проверяет, является ли расширенный символ печатным
(функция)
Документация C для isprint
ASCII values characters

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 \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 GHIJKLMNOP
QRSTUVWXYZ
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 ghijklmnop
qrstuvwxyz
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 символ backspace (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/isprint

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API