usr/src/lib/libc/locale/isupper.3

.\" Copyright (c) 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" the American National Standards Committee X3, on Information
.\" Processing Systems.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)isupper.3   5.2 (Berkeley) %G%
.\"
.Dd
.Dt ISUPPER 3
.Os
.Sh NAME
.Nm isupper
.Nd upper-case character test
.Sh SYNOPSIS
.Fd #include <ctype.h>
.Ft int
.Fn supper "int c"
.Sh DESCRIPTION
The
.Fn isupper
function tests for any upper-case letter or any of an
implementation-defined set of characters for which none of
.Xr iscntrl 3 ,
.Xr isdigit 3 ,
.Xr ispunct 3 ,
or
.Xr isspace 3
is true.
In the
.Em ``C''
locale,
.Fn isupper
returns true only for the characters defined as upper-case letters.
.Sh RETURN VALUES
The
.Fn isupper
macro returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh SEE ALSO
.Xr isascii 3 ,
.Xr isalnum 3 ,
.Xr isalpha 3 ,
.Xr iscntrl 3 ,
.Xr isdigit 3 ,
.Xr isgraph 3 ,
.Xr islower 3 ,
.Xr isprint 3 ,
.Xr ispunct 3 ,
.Xr isspace 3 ,
.Xr isxdigit 3 ,
.Xr toascii 3 ,
.Xr tolower 3 ,
.Xr toupper 3 ,
.Xr stdio 3
.Xr ascii 7
.Sh STANDARDS
The
.Xr isupper
function conforms to
.St -ansiC .