std::isspace

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Null-terminierte Byte-Strings

Funktionen
Zeichenklassifizierung
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
Zeichenmanipulation
tolower	toupper
Konvertierungen in numerische Formate
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
Stringmanipulation
strcpy strncpy strxfrm	strcat strncat
Stringuntersuchung
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Zeichen-Array-Funktionen
memchr memcmp memset	memcpy memmove
Sonstiges
strerror

 

Definiert in Header <cctype>
int isspace( int ch );

Prüft, ob das gegebene Zeichen ein Leerzeichen im Sinne der aktuell installierten C-Locale ist. In der Standard-Locale sind die Leerzeichen die folgenden:

• Leerzeichen (0x20, ' ')
• Seitenumbruch (0x0c, '\f')
• Zeilenvorschub (0x0a, '\n')
• Wagenrücklauf (0x0d, '\r')
• Horizontaler Tabulator (0x09, '\t')
• Vertikaler Tabulator (0x0b, '\v')

Das Verhalten ist undefiniert, wenn der Wert von ch nicht als unsigned char darstellbar ist und nicht gleich EOF ist.

Parameter

ch

-

zu klassifizierendes Zeichen

Rückgabewert

Ein von Null verschiedener Wert, wenn das Zeichen ein Leerzeichen ist, ansonsten Null.

Hinweise

Wie alle anderen Funktionen aus <cctype> ist das Verhalten von std::isspace undefiniert, wenn der Wert des Arguments weder als unsigned char darstellbar ist noch gleich EOF ist. Um diese Funktionen sicher mit normalen chars (oder signed chars) zu verwenden, sollte das Argument zuerst in unsigned char konvertiert werden.

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

Ebenso sollten sie nicht direkt mit Standardalgorithmen verwendet werden, wenn der Werttyp des Iterators char oder signed char ist. Konvertieren Sie stattdessen den Wert zuerst in unsigned char.

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
                        );
}

Beispiel

Führen Sie diesen Code aus

#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';
}

Ausgabe

09 0A 0B 0C 0D 20

Siehe auch

isspace(std::locale)	prüft, ob ein Zeichen von einer Locale als Leerzeichen klassifiziert wird (Funktionstemplate)
iswspace	prüft, ob ein breites Zeichen ein Leerzeichen ist (Funktion)
C-Dokumentation für isspace

ASCII-Werte			Zeichen	iscntrl iswcntrl	isprint iswprint	isspace iswspace	isblank iswblank	isgraph iswgraph	ispunct iswpunct	isalnum iswalnum	isalpha iswalpha	isupper iswupper	islower iswlower	isdigit iswdigit	isxdigit iswxdigit
dezimal	hexadezimal	oktal
0–8	\x0–\x8	\0–\10	Steuercodes (NUL, etc.)	≠0	0	0	0	0	0	0	0	0	0	0	0
9	\x9	\11	Tabulator (\t)	≠0	0	≠0	≠0	0	0	0	0	0	0	0	0
10–13	\xA–\xD	\12–\15	Leerzeichen (\n, \v, \f, \r)	≠0	0	≠0	0	0	0	0	0	0	0	0	0
14–31	\xE–\x1F	\16–\37	Steuercodes	≠0	0	0	0	0	0	0	0	0	0	0	0
32	\x20	\40	Leerzeichen	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	Rücktaste (DEL)	≠0	0	0	0	0	0	0	0	0	0	0	0