Print this page
11586 NAME field in man pages should match what's installed
*** 44,61 ****
.\" 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"
.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
.SH SYNOPSIS
- .LP
.nf
#include <ctype.h>
\fBint\fR \fBisalpha\fR(\fBint\fR \fIc\fR);
.fi
--- 44,60 ----
.\" 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 "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
.SH SYNOPSIS
.nf
#include <ctype.h>
\fBint\fR \fBisalpha\fR(\fBint\fR \fIc\fR);
.fi
*** 154,164 ****
.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,
--- 153,162 ----
*** 180,190 ****
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
.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
--- 178,188 ----
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
! \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,222 ****
.RE
.sp
.ne 2
.na
! \fB\fBisalnum()\fR\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
.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
.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)
--- 191,220 ----
.RE
.sp
.ne 2
.na
! \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
! \fBisascii()\fR
.ad
.RS 13n
Tests for any ASCII character, code between \fB0\fR and \fB0177\fR inclusive.
.RE
.sp
.ne 2
.na
! \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,251 ****
.RE
.sp
.ne 2
.na
! \fB\fBiscntrl()\fR\fR
.ad
.RS 13n
Tests for any ``control character'' as defined by the character set.
.RE
.sp
.ne 2
.na
! \fB\fBisdigit()\fR\fR
.ad
.RS 13n
Tests for any decimal-digit character.
.RE
.sp
.ne 2
.na
! \fB\fBisgraph()\fR\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.
--- 221,249 ----
.RE
.sp
.ne 2
.na
! \fBiscntrl()\fR
.ad
.RS 13n
Tests for any ``control character'' as defined by the character set.
.RE
.sp
.ne 2
.na
! \fBisdigit()\fR
.ad
.RS 13n
Tests for any decimal-digit character.
.RE
.sp
.ne 2
.na
! \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,262 ****
.RE
.sp
.ne 2
.na
! \fB\fBislower()\fR\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.
--- 250,260 ----
.RE
.sp
.ne 2
.na
! \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,275 ****
.RE
.sp
.ne 2
.na
! \fB\fBisprint()\fR\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.
--- 263,273 ----
.RE
.sp
.ne 2
.na
! \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,296 ****
.RE
.sp
.ne 2
.na
! \fB\fBispunct()\fR\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
.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,
--- 274,294 ----
.RE
.sp
.ne 2
.na
! \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
! \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,308 ****
.RE
.sp
.ne 2
.na
! \fB\fBisupper()\fR\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.
--- 296,306 ----
.RE
.sp
.ne 2
.na
! \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,321 ****
.RE
.sp
.ne 2
.na
! \fB\fBisxdigit()\fR\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
--- 309,319 ----
.RE
.sp
.ne 2
.na
! \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,344 ****
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 .
--- 326,340 ----
*** 350,358 ****
_
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)
--- 346,353 ----