function
<ios> <iostream>

std::nouppercase

ios_base& nouppercase (ios_base& str);
Do not generate upper case letters
Clears the uppercase format flag for the str stream.

When the uppercase format flag is not set, the letters automatically generated by the stream for certain representations (like some hexadecimal representations and numerical base prefixes) are not forced to be displayed using uppercase letters (generally using lowercase letters instead).

This flag can be set with the uppercase manipulator, forcing the use of uppercase for generated letters.

For standard streams, the uppercase flag is not set on initialization.

Parameters

str
Stream object whose format flag is affected.
Because this function is a manipulator, it is designed to be used alone with no arguments in conjunction with the insertion (<<) and extraction (>>) operations on streams (see example below).

Return Value

Argument str.

Example

1
2
3
4
5
6
7
8
9
// modify uppercase flag
#include <iostream>     // std::cout, std::showbase, std::hex
                        // std::uppercase, std::nouppercase
int main () {
  std::cout << std::showbase << std::hex;
  std::cout << std::uppercase << 77 << '\n';
  std::cout << std::nouppercase << 77 << '\n';
  return 0;
}

Possible output:
0X4D
0x4d


Data races

Modifies str. Concurrent access to the same stream object may cause data races.

Exception safety

Basic guarantee: if an exception is thrown, str is in a valid state.

See also