Print this page
11586 NAME field in man pages should match what's installed
@@ -44,18 +44,17 @@
.\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved.
.\" Portions Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved.
.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
.\" Copyright 2016 Joyent, Inc.
.\"
-.TH CTYPE 3C "Mar 14, 2016"
+.TH CTYPE 3C "Aug 20, 2019"
.SH NAME
ctype, isalpha, isalnum, isascii, isblank, iscntrl, isdigit, islower,
isprint, isspace, isupper, ispunct, isgraph, isxdigit, isalpha_l,
isalnum_l, isblank_l, iscntrl_l, isdigit_l, islower_l, isprint_l,
-isspace_l, isupper_l, ispunct_l, isgraph_l isxdigit_l \- character handling
+isspace_l, isupper_l, ispunct_l, isgraph_l, isxdigit_l \- character handling
.SH SYNOPSIS
-.LP
.nf
#include <ctype.h>
\fBint\fR \fBisalpha\fR(\fBint\fR \fIc\fR);
.fi
@@ -154,11 +153,10 @@
.LP
.nf
\fBint\fR \fBisxdigit_l\fR(\fBint\fR \fIc\fR, \fBlocale_t\fR \fIloc\fR);
.fi
.SH DESCRIPTION
-.LP
These functions classify character-coded integer values. Each is a
predicate returning non-zero for true, \fB0\fR for false. The behavior
of these macros, except \fBisascii()\fR, is affected by the current
locale (see \fBsetlocale\fR(3C) and \fBuselocale\fR(3C)). To modify
the behavior, change the \fBLC_TYPE\fR category in \fBsetlocale()\fR, that is,
@@ -180,11 +178,11 @@
representable as an \fBunsigned char\fR, or \fBEOF\fR, which is defined by the
<\fBstdio.h\fR> header and represents end-of-file.
.sp
.ne 2
.na
-\fB\fBisalpha()\fR\fR
+\fBisalpha()\fR
.ad
.RS 13n
Tests for any character for which \fBisupper()\fR or \fBislower()\fR is true,
or any character that is one of the current locale-defined set of characters
for which none of \fBiscntrl()\fR, \fBisdigit()\fR, \fBispunct()\fR, or
@@ -193,30 +191,30 @@
.RE
.sp
.ne 2
.na
-\fB\fBisalnum()\fR\fR
+\fBisalnum()\fR
.ad
.RS 13n
Tests for any character for which \fBisalpha()\fR or \fBisdigit()\fR is true
(letter or digit).
.RE
.sp
.ne 2
.na
-\fB\fBisascii()\fR\fR
+\fBisascii()\fR
.ad
.RS 13n
Tests for any ASCII character, code between \fB0\fR and \fB0177\fR inclusive.
.RE
.sp
.ne 2
.na
-\fB\fBisblank()\fR\fR
+\fBisblank()\fR
.ad
.RS 13n
Tests whether \fIc\fR is a character of class blank in the current locale. This
macro/function is not available to applications conforming to standards prior
to SUSv3. See \fBstandards\fR(5)
@@ -223,29 +221,29 @@
.RE
.sp
.ne 2
.na
-\fB\fBiscntrl()\fR\fR
+\fBiscntrl()\fR
.ad
.RS 13n
Tests for any ``control character'' as defined by the character set.
.RE
.sp
.ne 2
.na
-\fB\fBisdigit()\fR\fR
+\fBisdigit()\fR
.ad
.RS 13n
Tests for any decimal-digit character.
.RE
.sp
.ne 2
.na
-\fB\fBisgraph()\fR\fR
+\fBisgraph()\fR
.ad
.RS 13n
Tests for any character for which \fBisalnum()\fR and \fBispunct()\fR are true,
or any character in the current locale-defined "graph" class which is neither a
space ("\|") nor a character for which \fBiscntrl()\fR is true.
@@ -252,11 +250,11 @@
.RE
.sp
.ne 2
.na
-\fB\fBislower()\fR\fR
+\fBislower()\fR
.ad
.RS 13n
Tests for any character that is a lower-case letter or is one of the current
locale-defined set of characters for which none of \fBiscntrl()\fR,
\fBisdigit()\fR, \fBispunct()\fR, \fBisspace()\fR, or \fBisupper()\fR is true.
@@ -265,11 +263,11 @@
.RE
.sp
.ne 2
.na
-\fB\fBisprint()\fR\fR
+\fBisprint()\fR
.ad
.RS 13n
Tests for any character for which \fBiscntrl()\fR is false, and
\fBisalnum()\fR, \fBisgraph()\fR, \fBispunct()\fR, the space character ("\|"),
and the characters in the current locale-defined "print" class are true.
@@ -276,21 +274,21 @@
.RE
.sp
.ne 2
.na
-\fB\fBispunct()\fR\fR
+\fBispunct()\fR
.ad
.RS 13n
Tests for any printing character which is neither a space ("\|") nor a
character for which \fBisalnum()\fR or \fBiscntrl()\fR is true.
.RE
.sp
.ne 2
.na
-\fB\fBisspace()\fR\fR
+\fBisspace()\fR
.ad
.RS 13n
Tests for any space, tab, carriage-return, newline, vertical-tab or form-feed
(standard white-space characters) or for one of the current locale-defined set
of characters for which \fBisalnum()\fR is false. In the "C" locale,
@@ -298,11 +296,11 @@
.RE
.sp
.ne 2
.na
-\fB\fBisupper()\fR\fR
+\fBisupper()\fR
.ad
.RS 13n
Tests for any character that is an upper-case letter or is one of the current
locale-defined set of characters for which none of \fBiscntrl()\fR,
\fBisdigit()\fR, \fBispunct()\fR, \fBisspace()\fR, or \fBislower()\fR is true.
@@ -311,11 +309,11 @@
.RE
.sp
.ne 2
.na
-\fB\fBisxdigit()\fR\fR
+\fBisxdigit()\fR
.ad
.RS 14n
Tests for any hexadecimal-digit character (\fB[0\(mi9]\fR, \fB[A\(miF]\fR, or
\fB[a\(mif]\fR or the current locale-defined sets of characters representing
the hexadecimal digits \fB10\fR to \fB15\fR inclusive). In the "C" locale, only
@@ -328,17 +326,15 @@
are included.
.RE
.SH RETURN VALUES
-.LP
If the argument to any of the character handling macros is not in the domain of
the function, the result is undefined. Otherwise, the macro or function returns
non-zero if the classification is \fBTRUE\fR and \fB0\fR if the classification
is \fBFALSE\fR.
.SH ATTRIBUTES
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.TS
box;
c | c
l | l .
@@ -350,9 +346,8 @@
_
MT-Level MT-Safe
.TE
.SH SEE ALSO
-.LP
\fBnewlocale\fR(3C), \fBsetlocale\fR(3C), \fBuselocale\fR(3C),
\fBstdio\fR(3C), \fBascii\fR(5), \fBenviron\fR(5),
\fBstandards\fR(5)