function template
std::toupper
<locale>
template <class charT>
charT toupper ( charT c, const locale& loc );
Convert lowercase letter to uppercase using locale
Converts parameter
c to its uppercase equivalent if
c is a lowercase letter and has an uppercase equivalent using
ctype facet of locale
loc. If no such conversion is possible, the value returned is
c unchanged.
This function returns the same as a call to:
|
use_facet < ctype<charT> > (loc).toupper (c)
|
This function replicates the functionality of its
C-library equivalent
toupper. See
toupper for more info.
Parameters
- c
- Character to be converted.
- loc
- Locale to be used. Shall have facet ctype present.
Template parameter
charT is the character type.
Return Value
The uppercase equivalent to
c, if any. Or
c unchanged.
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14
|
// toupper example (C++)
#include <iostream>
#include <string>
#include <locale>
using namespace std;
int main ()
{
locale loc;
string str="Test String.\n";
for (size_t i=0; i<str.length(); ++i)
cout << toupper(str[i],loc);
return 0;
}
|
Output:
See also
- ctype
- Character type facet (class template)
- toupper (cctype)
- Convert lowercase letter to uppercase (function
)
- tolower
- Convert uppercase letter to lowercase using locale (function template)
- islower
- Check if character is a lowercase letter using locale (function template)
- isupper
- Check if character is an uppercase letter using locale (function template)
- isalpha
- Check if character is alphabetic using locale (function template)