Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::toupper — pretvorba enega znaka v veliko črko

std::toupper iz <cctype> vrne ustrezno veliko črko glede na trenutno krajevno nastavitev knjižnice C. Argument mora biti enak EOF ali predstavljiv kot unsigned char; vrnjeni tip je int.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

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

std::toupper iz <cctype> ima podpis int std::toupper(int c). Vrne ustrezno veliko črko glede na trenutno krajevno nastavitev knjižnice C ali nespremenjen argument, če pretvorba ni mogoča. Argumenta ne spremeni: rezultat priredite ali ga uporabite kako drugače.

Vrednost, podana parametru tipa int, mora biti enaka EOF ali predstavljiva s tipom unsigned char. Vsaka druga vrednost povzroči nedefinirano vedenje. Ker je navadni char lahko negativen, za spremenljivko tipa char uporabite std::toupper(static_cast<unsigned char>(ch)), če je vrednost po eksplicitni pretvorbi predstavljiva s tipom int. Če tip int ne more predstaviti vseh vrednosti tipa unsigned char, pred klicem preverite, ali je dobljena vrednost v območju tipa int. Drugače lahko pretvorba v int da negativno vrednost, ki ni enaka EOF, in povzroči nedefinirano vedenje. Če pretvorba da EOF, funkcija prejme EOF namesto vrednosti znaka. Če vhodna funkcija vrne vrednost tipa int, pred pretvorbo v unsigned char preverite, ali je enaka EOF.

Primer obdeluje niz znak za znakom in rezultat tipa int izrecno pretvori nazaj v char. Predpostavlja, da je vsaka vrednost, dobljena s pretvorbo v unsigned char, predstavljiva s tipom int. Pri začetni krajevni nastavitvi "C" je pričakovani izpis HELLO, C++23!, ki mu sledi znak za novo vrstico. To ni splošen postopek za pretvarjanje med malimi in velikimi črkami v Unicode: obdelava bajtov UTF-8 na ta način ne zadostuje.

Te funkcije ne zamenjujte s preobremenitvijo std::toupper(c, loc) iz <locale>, ki uporablja izrecno podan objekt krajevnih nastavitev. Zgornja navodila za pretvorbo v unsigned char veljajo za funkcijo z enim argumentom iz <cctype>.

Primeri

#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!

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri