cplusplus.com cplusplus.com
cplusplus.com   C++ : Reference : IOstream Library : manipulators : nouppercase
- -
C++
Information
Documentation
Reference
Articles
Sourcecode
Forum
Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
IOstream Library
manipulators
classes:
· filebuf
· fstream
· ifstream
· ios
· iostream
· ios_base
· istream
· istringstream
· ofstream
· ostream
· ostringstream
· streambuf
· stringbuf
· stringstream
objects:
· cerr
· cin
· clog
· cout
types:
· fpos
· streamoff
· streampos
· streamsize
manipulators
· boolalpha
· dec
· endl
· ends
· fixed
· flush
· hex
· internal
· left
· noboolalpha
· noshowbase
· noshowpoint
· noshowpos
· noskipws
· nounitbuf
· nouppercase
· oct
· resetiosflags
· right
· scientific
· setbase
· setfill
· setiosflags
· setprecision
· setw
· showbase
· showpoint
· showpos
· skipws
· unitbuf
· uppercase
· ws

-

nouppercase manipulator function
ios_base& nouppercase ( ios_base& str );
<ios>

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, hence being displayed using mostly lowercase letters.

This flag can be set with the uppercase manipulator, 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

// modify uppercase flag
#include <iostream>
using namespace std;

int main () {
  cout << showbase << hex;
  cout << nouppercase << 77 << endl;
  cout << uppercase << 77 << endl;
  return 0;
}

The execution of this example displays something similar to:

0x4d
0X4D

See also

uppercase Generate upper-case letters (manipulator 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)

© The C++ Resources Network, 2000-2007 - All rights reserved
Spotted an error? - contact us