std::uppercase, std::nouppercase - cppreference.com (original) (raw)

| Defined in header | | | | ----------------------------------------------------------------------------------------------- | --- | | | std::ios_base& uppercase( std::ios_base& str ); | (1) | | | std::ios_base& nouppercase( std::ios_base& str ); | (2) | |

Enables the use of uppercase characters in floating-point and hexadecimal integer output. Has no effect on input.

  1. Enables the uppercase flag in the stream str as if by calling str.setf(std::ios_base::uppercase).

  2. Disables the uppercase flag in the stream str as if by calling str.unsetf(std::ios_base::uppercase).

This is an I/O manipulator, it may be called with an expression such as out << std::uppercase for any out of type std::basic_ostream or with an expression such as in >> std::uppercase for any in of type std::basic_istream.

[edit] Parameters

str - reference to I/O stream

[edit] Return value

str (reference to the stream after manipulation).

[edit] Example

#include   int main() { std::cout << std::hex << std::showbase << "0x2a with uppercase: " << std::uppercase << 0x2a << '\n' << "0x2a with nouppercase: " << std::nouppercase << 0x2a << '\n' << "1e-10 with uppercase: " << std::uppercase << 1e-10 << '\n' << "1e-10 with nouppercase: " << std::nouppercase << 1e-10 << '\n'; }

Output:

0x2a with uppercase: 0X2A 0x2a with nouppercase: 0x2a 1e-10 with uppercase: 1E-10 1e-10 with nouppercase: 1e-10

[edit] See also