CKTIS / C++
std::uppercase — velká písmena v číselném výstupu
std::uppercase je manipulátor proudu, který ve formátovaném číselném výstupu vybírá velká písmena, například šestnáctkové číslice A–F a značku exponentu E. Nemění text ani neurčuje číselnou soustavu; nastavení zůstává aktivní, dokud se nezmění.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ios>
std::ios_base& std::uppercase(std::ios_base& str);
stream << std::uppercase;std::uppercase, deklarovaný v <ios>, je manipulátor formátování proudu, který se používá bez závorek: stream << std::uppercase. Volá str.setf(std::ios_base::uppercase) a vrací tentýž proud. std::uppercase je funkce, zatímco std::ios_base::uppercase je příznak formátování.
Při šestnáctkovém výstupu vybírá číslice A–F místo a–f. Pokud std::showbase zapne předponu, použije se 0X místo 0x. Při výstupu čísel s plovoucí desetinnou čárkou vybírá mimo jiné E místo e ve vědeckém zápisu a velká písmena v šestnáctkovém zápisu.
Manipulátor mění velikost písmen, nikoli číselnou soustavu. Celá čísla se vypisují v šestnáctkové soustavě, pokud je pole std::ios_base::basefield proudu nastaveno na std::ios_base::hex. Je-li tato hodnota již nastavena, není třeba nic měnit; jinak lze použít std::hex nebo zavolat stream.setf(std::ios_base::hex, std::ios_base::basefield). Manipulátor nemění na velká písmena znaky v zapisovaných řetězcích ani samostatné znaky a nemění názvy logických hodnot zapisované pomocí std::boolalpha.
Příznak patří konkrétnímu proudu a zůstává nastaven pro další operace, včetně operací po konci řádku. std::nouppercase jej zruší, ale ostatní nastavení, například std::hex nebo std::showbase, neresetuje. Pokud má funkce zachovat předchozí formátování, uložte auto saved = stream.flags(); a později je obnovte pomocí stream.flags(saved);.
Příklady
#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();
}
Výsledek
0XBEEF 0X1A 0xbeef
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.