CKTIS / C++
std::isspace — rozpoznawanie białych znaków
std::isspace z <cctype> rozpoznaje białe znaki według bieżących ustawień regionalnych C. Przy przekazywaniu char trzeba zadbać o poprawny zakres argumentu.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <cctype>
int std::isspace(int c);std::isspace z <cctype> zwraca wartość niezerową dla białego znaku, a 0 w przeciwnym przypadku; nie zakładaj wyniku 1. W ustawieniach regionalnych "C" rozpoznaje spację, \t, \n, \v, \f i \r.
Argument musi być równy EOF albo reprezentowalny jako unsigned char; inaczej zachowanie jest niezdefiniowane. Dla dowolnej wartości char wywołanie std::isspace(static_cast<unsigned char>(ch)) jest bezpieczne, jeśli UCHAR_MAX <= INT_MAX (obie stałe są dostępne w <climits>). Jeśli UCHAR_MAX > INT_MAX, najpierw zapisz wynik static_cast<unsigned char>(ch) w zmiennej u i wywołaj std::isspace(static_cast<int>(u)) tylko wtedy, gdy u <= INT_MAX. Większą wartość obsłuż osobno: konwersja do int może dać EOF zamiast wartości znaku albo inną wartość ujemną, dla której zachowanie funkcji jest niezdefiniowane. Wynik odczytu przechowywany jako int sprawdź względem EOF przed konwersją.
Klasyfikacja zależy od bieżących ustawień regionalnych C; funkcja nie dekoduje UTF-8. Odrębne przeciążenie std::isspace(ch, loc) z <locale> używa jawnie przekazanego obiektu std::locale i zwraca bool.
Przykłady
#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';
}
Wynik
3
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.