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