CKTIS / C++
std::toupper — pretvorba jednog znaka u veliko slovo
std::toupper iz <cctype> vraća odgovarajuće veliko slovo prema trenutačnim lokalnim postavkama biblioteke C. Argument mora biti jednak EOF ili prikaziv kao unsigned char; povratni tip je int.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <cctype>
int std::toupper(int c);std::toupper iz <cctype> ima potpis int std::toupper(int c). Vraća odgovarajuće veliko slovo prema trenutačnim lokalnim postavkama biblioteke C ili nepromijenjeni argument ako pretvorba nije moguća. Ne mijenja argument: dodijelite rezultat ili ga upotrijebite na drugi način.
Vrijednost predana parametru tipa int mora biti jednaka EOF ili prikaziva tipom unsigned char. Svaka druga vrijednost uzrokuje nedefinirano ponašanje. Budući da obični char može biti negativan, za varijablu tipa char upotrijebite std::toupper(static_cast<unsigned char>(ch)) pod uvjetom da je vrijednost nakon eksplicitne pretvorbe prikaziva tipom int. Ako tip int ne može prikazati sve vrijednosti tipa unsigned char, prije poziva provjerite je li dobivena vrijednost u rasponu tipa int. U suprotnom pretvorba u int može dati negativnu vrijednost različitu od EOF i uzrokovati nedefinirano ponašanje. Ako pretvorba da EOF, funkcija prima EOF umjesto vrijednosti znaka. Ako ulazna funkcija vrati vrijednost tipa int, provjerite je li jednaka EOF prije pretvorbe u unsigned char.
Primjer obrađuje niz znak po znak i izričito pretvara rezultat tipa int natrag u char. Pretpostavlja da je svaka vrijednost dobivena pretvorbom u unsigned char prikaziva tipom int. Uz početnu lokalnu postavku "C" očekivani je izlaz HELLO, C++23!, nakon kojeg slijedi znak novog retka. To nije općenit mehanizam za pretvorbu velikih i malih slova u Unicodeu: obrada UTF-8 bajtova na ovaj način nije dovoljna.
Nemojte brkati ovu funkciju s preopterećenjem std::toupper(c, loc) iz <locale>, koje upotrebljava izričito predan objekt lokalnih postavki. Gore navedene upute za pretvorbu u unsigned char odnose se na funkciju s jednim argumentom iz <cctype>.
Primjeri
#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';
}
Rezultat
HELLO, C++23!
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.