function template
<locale>
std::toupper
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, as determined by the ctype facet of locale loc. If no such conversion is possible, the value returned is c unchanged.
This function returns the same as if ctype::toupper is called as:
|
use_facet < ctype<charT> > (loc).toupper (c)
| |
This function template overloads the C function toupper (defined in <cctype>).
Parameters
- c
- Character to be converted.
- loc
- Locale to be used. It shall have a ctype facet.
The template argument charT is the character type.
Return Value
The uppercase equivalent to c, if any. Or c unchanged otherwise.
Example
1 2 3 4 5 6 7 8 9 10 11 12 13
|
// toupper example (C++)
#include <iostream> // std::cout
#include <string> // std::string
#include <locale> // std::locale, std::toupper
int main ()
{
std::locale loc;
std::string str="Test String.\n";
for (std::string::size_type i=0; i<str.length(); ++i)
std::cout << std::toupper(str[i],loc);
return 0;
}
| |
Output:
Data races
Both loc and its ctype facet are accessed.
Exception safety
Strong guarantee: if an exception is thrown, there are no effects.
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
)