CKTIS / C++
std::isspace — rozpoznávání bílých znaků
std::isspace z <cctype> rozpoznává bílé znaky podle aktuálního národního prostředí C. Při předávání hodnot typu char zajistěte, aby argument byl v povoleném rozsahu.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cctype>
int std::isspace(int c);std::isspace z <cctype> vrací pro bílé znaky nenulovou hodnotu a v opačném případě 0; nepředpokládejte, že vrátí 1. V národním prostředí "C" rozpoznává mezeru, \t, \n, \v, \f a \r.
Argument musí být roven EOF nebo reprezentovatelný jako unsigned char; jinak je chování nedefinované. Volání std::isspace(static_cast<unsigned char>(ch)) je bezpečné pro libovolnou hodnotu typu char, pokud platí UCHAR_MAX <= INT_MAX (obě mezní hodnoty jsou dostupné v <climits>). Pokud platí UCHAR_MAX > INT_MAX, nejprve uložte výsledek static_cast<unsigned char>(ch) do u a volejte std::isspace(static_cast<int>(u)) pouze tehdy, když u <= INT_MAX. Vyšší hodnotu zpracujte samostatně: převod na int může místo hodnoty znaku dát EOF nebo jinou zápornou hodnotu, pro kterou je chování volání nedefinované. Pokud je výsledek čtení uložen jako int, před převodem ověřte, zda se rovná EOF.
Klasifikace závisí na aktuálním národním prostředí C; funkce nedekóduje UTF-8. Samostatná varianta std::isspace(ch, loc) z <locale> používá explicitně předaný objekt std::locale a vrací bool.
Příklady
#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';
}
Výsledek
3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.