function
std::uppercase
<ios>
ios_base& uppercase ( ios_base& str );
Generate upper-case letters
Sets the
uppercase format flag for the
str stream.
When the
uppercase format flag is set, uppercase (capital) letters are used instead of lowercase for representations on insert operations involving stream-generated letters, like some hexadecimal representations and numerical base prefixes.
This flag can be unset with the
nouppercase manipulator, not forcing the use of uppercase for generated letters.
The
uppercase flag is
not set in standard streams on initialization.
Parameters
- str
- Stream object where to apply.
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
A reference to the stream object.
Example
1 2 3 4 5 6 7 8 9 10
|
// modify uppercase flag
#include <iostream>
using namespace std;
int main () {
cout << showbase << hex;
cout << uppercase << 77 << endl;
cout << nouppercase << 77 << endl;
return 0;
}
|
The execution of this example displays something similar to:
See also
- nouppercase
- Do not generate upper case letters (function)
- ios_base::flags
- Get/set format flags (public member function)
- ios_base::setf
- Set specific format flags (public member function)
- ios_base::unsetf
- Clear specific format flags (public member function)