Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::isspace — reconhecer espaços em branco

std::isspace de <cctype> reconhece espaços em branco com base na localização C atual. Ao passar valores char, certifique-se de que o argumento está dentro do intervalo permitido.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

std::isspace de <cctype> devolve um valor diferente de zero para espaços em branco e 0 nos restantes casos; não presuma que devolve 1. Na localização "C", reconhece o espaço, \t, \n, \v, \f e \r.

O argumento tem de ser igual a EOF ou representável como unsigned char; caso contrário, o comportamento é indefinido. Para qualquer valor do tipo char, a chamada std::isspace(static_cast<unsigned char>(ch)) é segura se UCHAR_MAX <= INT_MAX (ambos os limites estão disponíveis em <climits>). Se UCHAR_MAX > INT_MAX, guarde primeiro o resultado de static_cast<unsigned char>(ch) em u e chame std::isspace(static_cast<int>(u)) apenas se u <= INT_MAX. Trate separadamente um valor superior: a conversão para int pode produzir EOF em vez do valor do carácter ou outro valor negativo para o qual a chamada tem um comportamento indefinido. Se um resultado de leitura estiver guardado como int, verifique se é igual a EOF antes de o converter.

A classificação depende da localização C atual; a função não descodifica UTF-8. A sobrecarga distinta std::isspace(ch, loc) de <locale> utiliza um objeto std::locale passado explicitamente e devolve bool.

Exemplos

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

Resultado

3

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes