isupper

Tests whether an element in a locale is in upper case.

template<Class CharType>
   bool isupper(
      CharType _Ch, 
      const locale& _Loc
   )

Parameters

  • _Ch
    The element to be tested.

  • _Loc
    The locale containing the element to be tested.

Return Value

true if the element tested is an uppercase character; false if it is not.

Remarks

The template function returns use_facet<ctype<CharType> >(_Loc).is(ctype<CharType>::upper, _Ch).

Example

// locale_isupper.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )   
{
   locale loc ( "German_Germany" );
   bool result1 = isupper ( 'L', loc );
   bool result2 = isupper ( 'n', loc );
   bool result3 = isupper ( '3', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a uppercase character." << endl;

   if ( result2 )
      cout << "The character 'n' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character 'n' in the locale is "
           << " not a uppercase character." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not a uppercase character." << endl;
}

Output

The character 'L' in the locale is a uppercase character.
The character 'n' in the locale is  not a uppercase character.
The character '3' in the locale is  not a uppercase character.

Requirements

Header: <locale>

Namespace: std

See Also

Concepts

<locale> Members