Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::toupper — zamiana pojedynczego znaku na wielką literę

std::toupper z <cctype> zwraca wielką literę odpowiadającą znakowi według bieżących ustawień regionalnych C. Argument musi być równy EOF lub mieścić się w zakresie unsigned char; wynik ma typ int.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

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

std::toupper z <cctype> ma sygnaturę int std::toupper(int c). Zwraca odpowiednią wielką literę według bieżących ustawień regionalnych C albo niezmieniony argument, gdy zamiana nie jest możliwa. Nie modyfikuje argumentu — wynik trzeba przypisać lub wykorzystać.

Wartość przekazana do parametru typu int musi być równa EOF albo reprezentowalna przez unsigned char. Inna wartość powoduje niezdefiniowane zachowanie. Zwykły char może być ujemny, dlatego dla zmiennej typu char stosuje się std::toupper(static_cast<unsigned char>(ch)), pod warunkiem że wartość po rzutowaniu mieści się w zakresie int. Jeśli int nie może reprezentować wszystkich wartości unsigned char, przed wywołaniem sprawdź, czy otrzymana wartość mieści się w zakresie int. W przeciwnym razie konwersja do int może dać ujemną wartość inną niż EOF i spowodować niezdefiniowane zachowanie. Jeśli da EOF, funkcja otrzyma EOF zamiast wartości znaku. Wartość zwróconą jako int przez funkcję wejścia sprawdź pod kątem EOF przed konwersją na unsigned char.

Przykład przetwarza napis znak po znaku i jawnie konwertuje wynik typu int z powrotem na char. Zakłada, że każda wartość otrzymana po rzutowaniu na unsigned char mieści się w zakresie int. Oczekiwane wyjście to HELLO, C++23! i znak nowego wiersza przy początkowych ustawieniach regionalnych "C". Nie jest to ogólny mechanizm zamiany wielkości liter Unicode: przetwarzanie bajtów UTF-8 w ten sposób nie wystarcza.

Nie myl tej funkcji z przeciążeniem std::toupper(c, loc) z <locale>, które korzysta z jawnie przekazanego obiektu ustawień regionalnych. Powyższe wskazówki dotyczące rzutowania na unsigned char odnoszą się do jednoargumentowej funkcji z <cctype>.

Przykłady

#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';
}

Wynik

HELLO, C++23!

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła