Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/io/manip/uppercase"

From cppreference.com
< cpp‎ | io‎ | manip
m (Text replace - "/sidebar" to "/navbar")
m (fmt, @@, capitalized 1st letter, {{c}}, ., langlinks)
 
(3 intermediate revisions by one user not shown)
Line 1: Line 1:
 
{{cpp/title|uppercase|nouppercase}}
 
{{cpp/title|uppercase|nouppercase}}
 
{{cpp/io/manip/navbar}}
 
{{cpp/io/manip/navbar}}
{{ddcl list begin}}
+
{{dcl begin}}
{{ddcl list header|ios}}
+
{{dcl header|ios}}
{{ddcl list item | num = 1|
+
{{dcl|num=1|
 
std::ios_base& uppercase( std::ios_base& str );
 
std::ios_base& uppercase( std::ios_base& str );
 
}}
 
}}
{{ddcl list item | num = 2|
+
{{dcl|num=2|
 
std::ios_base& nouppercase( std::ios_base& str );
 
std::ios_base& nouppercase( std::ios_base& str );
 
}}
 
}}
{{ddcl list end}}
+
{{dcl end}}
  
 
Enables the use of uppercase characters in floating-point and hexadecimal integer output. Has no effect on input.
 
Enables the use of uppercase characters in floating-point and hexadecimal integer output. Has no effect on input.
  
1) enables the {{tt|uppercase}} flag in the stream {{tt|str}} as if by calling {{c|str.setf(std::ios_base::uppercase)}}
+
@1@ Enables the {{tt|uppercase}} flag in the stream {{c|str}} as if by calling {{c|str.setf(std::ios_base::uppercase)}}.
  
2) disables the {{tt|uppercase}} flag in the stream {{tt|str}} as if by calling {{c|str.unsetf(std::ios_base::uppercase)}}
+
@2@ Disables the {{tt|uppercase}} flag in the stream {{c|str}} as if by calling {{c|str.unsetf(std::ios_base::uppercase)}}.
  
This is an I/O manipulator, it may be called with an expression such as {{c|out << std::uppercase}} for any {{tt|out}} of type {{c|std::basic_ostream}} or with an expression such as {{c|in >> std::uppercase}} for any {{tt|in}} of type {{c|std::basic_istream}}.
+
This is an I/O manipulator, it may be called with an expression such as {{c|out << std::uppercase}} for any {{tt|out}} of type {{lc|std::basic_ostream}} or with an expression such as {{c|in >> std::uppercase}} for any {{tt|in}} of type {{lc|std::basic_istream}}.
  
 
===Parameters===
 
===Parameters===
{{param list begin}}
+
{{par begin}}
{{param list item | str | reference to I/O stream }}
+
{{par|str|reference to I/O stream}}
{{param list end}}
+
{{par end}}
  
 
===Return value===
 
===Return value===
 
+
{{c|str}} (reference to the stream after manipulation).
{{tt|str}} (reference to the stream after manipulation)
+
  
 
===Example===
 
===Example===
 
{{example
 
{{example
|
+
|code=
| code=
+
 
#include <iostream>
 
#include <iostream>
 +
 
int main()
 
int main()
 
{
 
{
Line 41: Line 40:
 
               << "1e-10 with nouppercase: " << std::nouppercase << 1e-10 << '\n';
 
               << "1e-10 with nouppercase: " << std::nouppercase << 1e-10 << '\n';
 
}
 
}
| output=
+
|output=
 
0x2a with uppercase: 0X2A
 
0x2a with uppercase: 0X2A
 
0x2a with nouppercase: 0x2a
 
0x2a with nouppercase: 0x2a
Line 49: Line 48:
  
 
===See also===
 
===See also===
{{dcl list begin}}
+
{{dsc begin}}
{{dcl list template | cpp/io/manip/dcl list resetiosflags}}
+
{{dsc inc|cpp/io/manip/dsc resetiosflags}}
{{dcl list template | cpp/io/manip/dcl list setiosflags}}
+
{{dsc inc|cpp/io/manip/dsc setiosflags}}
{{dcl list end}}
+
{{dsc end}}
 +
 
 +
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Latest revision as of 23:26, 15 September 2023

 
 
 
Input/output manipulators
Floating-point formatting
Integer formatting
Boolean formatting
Field width and fill control
Other formatting
uppercasenouppercase
Whitespace processing
Output flushing
(C++20)  

Status flags manipulation
Time and money I/O
(C++11)
(C++11)
(C++11)
(C++11)
Quoted manipulator
(C++14)
 
Defined in header <ios>
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.

Contents

[edit] Parameters

str - reference to I/O stream

[edit] Return value

str (reference to the stream after manipulation).

[edit] 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

[edit] See also

clears the specified ios_base flags
(function) [edit]
sets the specified ios_base flags
(function) [edit]