CKTIS / C++
std::toupper — převod jednoho znaku na velké písmeno
std::toupper z <cctype> vrací odpovídající velké písmeno podle aktuálního nastavení národního prostředí C. Argument musí být roven EOF nebo reprezentovatelný jako unsigned char; návratový typ je int.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cctype>
int std::toupper(int c);std::toupper z <cctype> má signaturu int std::toupper(int c). Vrací odpovídající velké písmeno podle aktuálního národního prostředí C, případně nezměněný argument, pokud převod není možný. Argument nemění: výsledek přiřaďte nebo jej jinak použijte.
Hodnota předaná parametru typu int musí být rovna EOF nebo reprezentovatelná jako unsigned char. Jakákoli jiná hodnota způsobuje nedefinované chování. Protože obyčejný char může být záporný, použijte pro proměnnou typu char výraz std::toupper(static_cast<unsigned char>(ch)), pokud se hodnota po přetypování vejde do rozsahu typu int. Pokud int nedokáže reprezentovat všechny hodnoty typu unsigned char, před voláním ověřte, že se získaná hodnota do rozsahu typu int vejde. Jinak může převod na int dát zápornou hodnotu odlišnou od EOF a způsobit nedefinované chování. Pokud převod dá EOF, funkce obdrží EOF místo hodnoty znaku. U hodnoty vrácené vstupní funkcí jako int před převodem na unsigned char ověřte, zda není rovna EOF.
Příklad zpracovává řetězec znak po znaku a výsledek typu int výslovně převádí zpět na char. Předpokládá, že se každá hodnota získaná přetypováním na unsigned char vejde do rozsahu typu int. Při počátečním národním prostředí "C" je očekávaným výstupem HELLO, C++23! následované znakem nového řádku. Nejde o obecný mechanismus převodu velikosti písmen pro Unicode: zpracování bajtů UTF-8 tímto způsobem nestačí.
Nezaměňujte tuto funkci za přetížení std::toupper(c, loc) z <locale>, které používá výslovně předaný objekt národního prostředí. Výše uvedené pokyny k přetypování na unsigned char se vztahují na jednoargumentovou funkci z <cctype>.
Pří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ýsledek
HELLO, C++23!
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.