CKTIS / C++
std::isspace — Leerraumzeichen erkennen
std::isspace aus <cctype> erkennt Leerraumzeichen anhand der aktuellen C-Gebietseinstellungen. Beim Übergeben von char-Werten muss das Argument im zulässigen Wertebereich liegen.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cctype>
int std::isspace(int c);std::isspace aus <cctype> liefert für Leerraumzeichen einen Wert ungleich null und andernfalls 0; gehen Sie nicht davon aus, dass das Ergebnis 1 ist. In der Gebietseinstellung "C" erkennt die Funktion Leerzeichen, \t, \n, \v, \f und \r.
Das Argument muss EOF entsprechen oder als unsigned char darstellbar sein; andernfalls ist das Verhalten undefiniert. Für jeden char-Wert ist std::isspace(static_cast<unsigned char>(ch)) sicher, wenn UCHAR_MAX <= INT_MAX gilt (beide Grenzwerte sind in <climits> verfügbar). Wenn UCHAR_MAX > INT_MAX gilt, speichern Sie das Ergebnis von static_cast<unsigned char>(ch) zunächst in u und rufen Sie std::isspace(static_cast<int>(u)) nur auf, wenn u <= INT_MAX gilt. Behandeln Sie einen größeren Wert gesondert: Bei der Umwandlung in int kann statt des Zeichenwerts EOF oder ein anderer negativer Wert entstehen, bei dem der Aufruf undefiniertes Verhalten hat. Prüfen Sie ein als int gespeichertes Leseergebnis vor der Umwandlung auf EOF.
Die Klassifizierung hängt von den aktuellen C-Gebietseinstellungen ab; die Funktion dekodiert kein UTF-8. Die separate Überladung std::isspace(ch, loc) aus <locale> verwendet ein explizit übergebenes std::locale-Objekt und gibt bool zurück.
Beispiele
#include <cctype>
#include <climits>
#include <clocale>
#include <iostream>
int main() {
static_assert(UCHAR_MAX <= INT_MAX, "This example requires UCHAR_MAX <= INT_MAX.");
std::setlocale(LC_CTYPE, "C");
const char text[] = "A B\tC\n";
int count = 0;
for (char ch : text) {
if (std::isspace(static_cast<unsigned char>(ch)) != 0) {
++count;
}
}
std::cout << count << '\n';
}
Ergebnis
3
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.