CKTIS / C++
std::toupper — prevod jedného znaku na veľké písmeno
std::toupper z <cctype> vracia zodpovedajúce veľké písmeno podľa aktuálneho nastavenia národného prostredia C. Argument musí byť rovný EOF alebo reprezentovateľný ako unsigned char; návratový typ je int.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cctype>
int std::toupper(int c);std::toupper z <cctype> má signatúru int std::toupper(int c). Vracia zodpovedajúce veľké písmeno podľa aktuálneho národného prostredia C alebo nezmenený argument, ak prevod nie je možný. Argument nemení: výsledok priraďte alebo ho inak použite.
Hodnota odovzdaná parametru typu int musí byť rovná EOF alebo reprezentovateľná ako unsigned char. Akákoľvek iná hodnota spôsobuje nedefinované správanie. Keďže obyčajný char môže byť záporný, pri premennej typu char použite std::toupper(static_cast<unsigned char>(ch)), ak sa hodnota po pretypovaní zmestí do rozsahu typu int. Ak int nedokáže reprezentovať všetky hodnoty typu unsigned char, pred volaním overte, či sa získaná hodnota zmestí do rozsahu typu int. Inak môže prevod na int dať zápornú hodnotu odlišnú od EOF a spôsobiť nedefinované správanie. Ak prevod dá EOF, funkcia dostane EOF namiesto hodnoty znaku. Pri hodnote vrátenej vstupnou funkciou ako int pred prevodom na unsigned char skontrolujte, či sa nerovná EOF.
Príklad spracúva reťazec znak po znaku a výsledok typu int výslovne prevádza späť na char. Predpokladá, že každá hodnota získaná pretypovaním na unsigned char sa zmestí do rozsahu typu int. Pri počiatočnom národnom prostredí "C" je očakávaným výstupom HELLO, C++23!, za ktorým nasleduje znak nového riadka. Nejde o všeobecný mechanizmus prevodu veľkosti písmen pre Unicode: spracovanie bajtov UTF-8 týmto spôsobom nestačí.
Nezamieňajte si túto funkciu s preťažením std::toupper(c, loc) z <locale>, ktoré používa výslovne odovzdaný objekt národného prostredia. Vyššie uvedené pokyny na pretypovanie na unsigned char sa vzťahujú na jednoargumentovú funkciu z <cctype>.
Príklady
#include <cctype>
#include <iostream>
#include <string>
int main() {
std::string text = "Hello, C++23!";
for (char& ch : text) {
ch = static_cast<char>(
std::toupper(static_cast<unsigned char>(ch)));
}
std::cout << text << '\n';
}
Výsledok
HELLO, C++23!
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.