Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

isupper, iswupper

int isupper(
   int c 
);
int iswupper(
   wint_t c 
);

Each of these routines returns nonzero if c is a particular representation of an uppercase letter.

Parameter

c
Integer to test.

Return Value

isupper returns a non-zero value if c is an uppercase character (a – z). iswupper returns a non-zero value if c is a wide character that corresponds to an uppercase letter, or if c is one of an implementation-defined set of wide characters for which none of iswcntrl, iswdigit, iswpunct, or iswspace is nonzero. Each of these routines returns 0 if c does not satisfy the test condition.

The result of the test condition for the isupper function depends on the LC_CTYPE category setting of the current locale; see setlocale for more information. For iswupper, the result of the test condition is independent of locale.

When used with a debug CRT library, isupper will display a CRT assert if passed a parameter that isn't EOF or in the range of 0 through 0xFF. When used with a debug CRT library, isupper will use the parameter as an index into an array, with undefined results if the parameter isn't EOF or in the range of 0 through 0xFF.

Generic-Text Routine Mappings

TCHAR.H routine _UNICODE & _MBCS not defined _MBCS defined _UNICODE defined
_istupper isupper _ismbcupper iswupper

Requirements

Routine Required header Compatibility
isupper <ctype.h> ANSI, Win 98, Win Me, Win NT, Win 2000, Win XP
iswupper <ctype.h> or <wchar.h> ANSI, Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

See Also

Character Classification Routines | Locale Routines | is, isw Function Overview | Run-Time Routines and .NET Framework Equivalents

Show:
© 2015 Microsoft