NAME

isupper, isupper_l — upper-case singly-byte character test

SYNOPSIS

#include <ctype.h>

int
isupper(int c);

int
isupper_l(int c, locale_t locale);

DESCRIPTION

The isupper() and isupper_l() functions test whether c represents an upper-case letter.

In the C locale, the complete list of upper-case letters is A–Z. OpenBSD always uses the C locale for these functions, ignoring the global locale, the thread-specific locale, and the locale argument.

RETURN VALUES

These functions return zero if the character tests false or non-zero if the character tests true.

ENVIRONMENT

On systems supporting non-ASCII single-byte character encodings, these functions may return non-zero for additional characters, and the results of isupper() may depend on the LC_CTYPE locale(1), but they never return non-zero for any character for which iscntrl(3), isdigit(3), ispunct(3), or isspace(3) is true.

SEE ALSO

isalnum(3), isalpha(3), isascii(3), isblank(3), iscntrl(3), isdigit(3), isgraph(3), islower(3), isprint(3), ispunct(3), isspace(3), iswupper(3), isxdigit(3), stdio(3), toascii(3), tolower(3), toupper(3), ascii(7)

STANDARDS

The isupper() function conforms to ANSI X3.159-1989 (“ANSI C89”), and isupper_l() to IEEE Std 1003.1-2008 (“POSIX.1”).

HISTORY

The isupper() function first appeared in Version 7 AT&T UNIX, and isupper_l() has been available since OpenBSD 6.2.

CAVEATS

The argument c must be EOF or representable as an unsigned char; otherwise, the result is undefined.