isupper


function template
<locale> 
template <class charT>
  bool isupper ( charT c, const locale& loc );

Check if character is an uppercase letter using locale

Checks whether c is an uppercase letter using ctype facet of locale loc, returning the same as a call to:

  
use_facet < ctype<charT> > (loc).is (ctype_base::upper, c)


This function replicates the functionality of its C-library equivalent isupper. See isupper for more info.

Parameters

c
Character to be checked.
loc
Locale to be used. Shall have facet ctype present.


Template parameter charT is the character type.

Return Value

true if indeed c is an uppercase letter, false otherwise.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
 
// isupper example (C++)
#include <iostream>
#include <string>
#include <locale>
using namespace std;

int main ()
{
  locale loc;
  string str="Test String.\n";
  char c;
  for (size_t i=0; i<str.length(); ++i)
  {
    c=str[i];
    if (isupper(c,loc)) c=tolower(c,loc);
    cout << c;
  }
  return 0;
}


Output:
test string.


See also

ctype Character type facet (class template)
isupper (cctype) Check if character is uppercase letter (function)
islower Check if character is a lowercase letter using locale (function template)
isalpha Check if character is alphabetic using locale (function template)
toupper Convert lowercase letter to uppercase using locale (function template)
tolower Convert uppercase letter to lowercase using locale (function template)