Spec-Zone.ru › C++

std::isspace

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

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

  • пробел (0x20, ' ')
  • перевод страницы (0x0c, '\f')
  • перевод строки (0x0a, '\n')
  • возврат каретки (0x0d, '\r')
  • горизонтальная табуляция (0x09, '\t')
  • вертикальная табуляция (0x0b, '\v')

Поведение не определено, если значение ch нельзя представить типом unsignedchar и оно не равно EOF.

Параметры

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

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

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

Примечания

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

bool my_isspace(char ch)
{
    return std::isspace(static_cast<unsigned char>(ch));
}

Аналогично, их не следует напрямую использовать со стандартными алгоритмами, если тип значения итератора — char или signedchar. Вместо этого сначала преобразуйте значение к типу unsignedchar:

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

Пример

#include <cctype>
#include <climits>
#include <iomanip>
#include <iostream>
 
int main(void)
{
    std::cout << std::hex << std::setfill('0') << std::uppercase;
    for (int ch{}; ch <= UCHAR_MAX; ++ch)
        if (std::isspace(ch))
            std::cout << std::setw(2) << ch << ' ';
    std::cout << '\n';
}

Вывод:

09 0A 0B 0C 0D 20

См. также

isspace(std::locale)
проверяет, классифицируется ли символ как пробельный в локали
(шаблон функции)
iswspace
проверяет, является ли широкий символ пробельным
(функция)
Документация C для isspace
Значения 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 \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 символ забоя (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/isspace

Spec-Zone.ru

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