Namespaces
Variants
Views
Actions

std::uppercase, std::nouppercase

From cppreference.com
< cpp‎ | io‎ | manip
Revision as of 15:48, 2 November 2012 by P12bot (Talk | contribs)

Template:ddcl list begin <tr class="t-dsc-header">

<td>
Defined in header <ios>
</td>

<td></td> <td></td> <tr class="t-dcl ">

<td >
std::ios_base& uppercase( std::ios_base& str );
</td>

<td > (1) </td> <td class="t-dcl-nopad"> </td> </tr> <tr class="t-dcl ">

<td >
std::ios_base& nouppercase( std::ios_base& str );
</td>

<td > (2) </td> <td class="t-dcl-nopad"> </td> </tr> Template:ddcl list end

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.

Contents

Parameters

str - reference to I/O stream

Return value

str (reference to the stream after manipulation)

Example

#include <iostream>
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

See also

Template:cpp/io/manip/dcl list resetiosflagsTemplate:cpp/io/manip/dcl list setiosflags