Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::isspace — riconoscere gli spazi bianchi

std::isspace di <cctype> riconosce gli spazi bianchi in base alle impostazioni locali C correnti. Quando passi valori char, assicurati che l'argomento rientri nell'intervallo consentito.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <cctype>
int std::isspace(int c);

std::isspace di <cctype> restituisce un valore diverso da zero per gli spazi bianchi e 0 negli altri casi; non dare per scontato che restituisca 1. Con le impostazioni locali "C", riconosce lo spazio, \t, \n, \v, \f e \r.

L'argomento deve essere uguale a EOF oppure rappresentabile come unsigned char; in caso contrario, il comportamento è indefinito. Per qualsiasi valore di tipo char, la chiamata std::isspace(static_cast<unsigned char>(ch)) è sicura se UCHAR_MAX <= INT_MAX (entrambi i limiti sono disponibili in <climits>). Se UCHAR_MAX > INT_MAX, salva prima il risultato di static_cast<unsigned char>(ch) in u e chiama std::isspace(static_cast<int>(u)) solo se u <= INT_MAX. Gestisci a parte un valore maggiore: la conversione a int può produrre EOF al posto del valore del carattere oppure un altro valore negativo per il quale la chiamata ha un comportamento indefinito. Se il risultato di una lettura è memorizzato come int, controlla se è uguale a EOF prima di convertirlo.

La classificazione dipende dalle impostazioni locali C correnti; la funzione non decodifica UTF-8. L'overload distinto std::isspace(ch, loc) di <locale> usa un oggetto std::locale passato esplicitamente e restituisce bool.

Esempi

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

Risultato

3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti