Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::uppercase — wielkie litery w zapisie liczb

std::uppercase to manipulator strumienia, który wybiera wielkie litery w formatowanym zapisie liczb, np. cyfry szesnastkowe A–F i znacznik wykładnika E. Nie zmienia tekstu ani podstawy liczbowej; ustawienie pozostaje aktywne do jego zmiany.

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

Składnia

#include <ios>
std::ios_base& std::uppercase(std::ios_base& str);
stream << std::uppercase;

std::uppercase, zadeklarowany w <ios>, jest manipulatorem formatowania strumienia używanym bez nawiasów: stream << std::uppercase. Wywołuje str.setf(std::ios_base::uppercase) i zwraca ten sam strumień. std::uppercase jest funkcją, natomiast std::ios_base::uppercase jest flagą formatowania.

Przy wyjściu szesnastkowym wybiera cyfry A–F zamiast a–f. Gdy prefiks jest włączony przez std::showbase, używa 0X zamiast 0x. W zapisie zmiennoprzecinkowym wybiera m.in. E zamiast e w notacji naukowej oraz wielkie litery w notacji szesnastkowej.

Manipulator zmienia wielkość liter, a nie podstawę liczbową. Liczby całkowite są wypisywane szesnastkowo, gdy w polu std::ios_base::basefield strumienia jest ustawiona flaga std::ios_base::hex. Jeśli flaga jest już ustawiona, nie trzeba nic zmieniać; w przeciwnym razie można użyć std::hex lub wywołać stream.setf(std::ios_base::hex, std::ios_base::basefield). Manipulator nie zmienia wielkości liter w wypisywanych napisach ani pojedynczych znakach i nie zmienia nazw wartości logicznych wypisywanych przez std::boolalpha.

Flaga dotyczy danego strumienia i pozostaje ustawiona dla kolejnych operacji, także po końcu wiersza. std::nouppercase ją usuwa, ale nie resetuje innych ustawień, takich jak std::hex czy std::showbase. Jeśli funkcja ma zachować wcześniejsze formatowanie, zapisz auto saved = stream.flags(); i później przywróć je przez stream.flags(saved);.

Przykłady

#include <ios>
#include <iostream>
#include <locale>
#include <sstream>

int main() {
    std::ostringstream out;
    out.imbue(std::locale::classic());
    out << std::hex << std::showbase
        << std::uppercase << 48879 << ' ' << 26 << '\n'
        << std::nouppercase << 48879 << '\n';
    std::cout << out.str();
}

Wynik

0XBEEF 0X1A
0xbeef

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

Źródła