[unix-history] / usr / src / lib / libc / locale / ctype.3

.\"	@(#)ctype.3	6.4 (Berkeley) %G%
.\"
.TH CTYPE 3  ""
.AT 3
.SH NAME
isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, isascii, toupper, tolower, toascii \- character classification macros
.SH SYNOPSIS
.B #include <ctype.h>
.PP
.B isalpha(c)
.PP
.B . . .
.SH DESCRIPTION
These macros classify ASCII-coded integer values
by table lookup.
Each is a predicate returning nonzero for true,
zero for false.
.I Isascii
and
.I toascii
are defined on all integer values; the rest
are defined only where 
.I isascii
is true and on the single non-ASCII value
EOF (see
.IR stdio (3S)).
.TP 15n
.I isalpha
.I c
is a letter
.TP
.I isupper
.I c
is an upper case letter
.TP
.I islower 
.I c
is a lower case letter
.TP
.I isdigit
.I c
is a digit
.TP
.I isxdigit
.I c
is a hex digit
.TP
.I isalnum
.I c
is an alphanumeric character
.TP
.I isspace
.I c
is a space, tab, carriage return, newline, vertical tab, or formfeed
.TP
.I ispunct
.I c
is a punctuation character (neither control nor alphanumeric)
.TP
.I isprint
.I c
is a printing character, code 040(8) (space) through 0176 (tilde)
.TP
.I isgraph
.I c
is a printing character, similar to
.I isprint
except false for space.
.TP
.I iscntrl
.I c
is a delete character (0177) or ordinary control character
(less than 040).
.TP
.I isascii
.I c
is an ASCII character, code less than 0200
.TP
.I tolower
.I c
is converted to lower case.  Return value is undefined if not 
.I isupper(c).
.TP
.I toupper
.I c
is converted to upper case.  Return value is undefined if not 
.I islower(c).
.TP
.I toascii
.I c
is converted to be a valid ascii character.
.SH "SEE ALSO"
ascii(7)
Commit	Line	Data
888bd009	1	.\" @(#)ctype.3 6.4 (Berkeley) %G%
ec009048	2	.\"
d73c83fb	3	.TH CTYPE 3 ""
ec009048 KM	4	.AT 3
ec009048 KM	5	.SH NAME
f1f628bd	6	isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, isascii, toupper, tolower, toascii \- character classification macros
ec009048 KM	7	.SH SYNOPSIS
	8	.B #include <ctype.h>
	9	.PP
	10	.B isalpha(c)
	11	.PP
	12	.B . . .
	13	.SH DESCRIPTION
	14	These macros classify ASCII-coded integer values
	15	by table lookup.
	16	Each is a predicate returning nonzero for true,
	17	zero for false.
	18	.I Isascii
f1f628bd JB	19	and
	20	.I toascii
	21	are defined on all integer values; the rest
ec009048 KM	22	are defined only where
	23	.I isascii
	24	is true and on the single non-ASCII value
	25	EOF (see
b54f16c2	26	.IR stdio (3S)).
ec009048 KM	27	.TP 15n
	28	.I isalpha
	29	.I c
	30	is a letter
	31	.TP
	32	.I isupper
	33	.I c
	34	is an upper case letter
	35	.TP
	36	.I islower
	37	.I c
	38	is a lower case letter
	39	.TP
	40	.I isdigit
	41	.I c
	42	is a digit
	43	.TP
d73c83fb KM	44	.I isxdigit
	45	.I c
	46	is a hex digit
	47	.TP
ec009048 KM	48	.I isalnum
	49	.I c
	50	is an alphanumeric character
	51	.TP
	52	.I isspace
	53	.I c
d73c83fb	54	is a space, tab, carriage return, newline, vertical tab, or formfeed
ec009048 KM	55	.TP
	56	.I ispunct
	57	.I c
	58	is a punctuation character (neither control nor alphanumeric)
	59	.TP
	60	.I isprint
	61	.I c
f1f628bd JB	62	is a printing character, code 040(8) (space) through 0176 (tilde)
	63	.TP
	64	.I isgraph
	65	.I c
888bd009	66	is a printing character, similar to
f1f628bd JB	67	.I isprint
f1f628bd JB	68	except false for space.
ec009048 KM	69	.TP
	70	.I iscntrl
	71	.I c
	72	is a delete character (0177) or ordinary control character
7a4be743	73	(less than 040).
ec009048 KM	74	.TP
	75	.I isascii
	76	.I c
	77	is an ASCII character, code less than 0200
f1f628bd JB	78	.TP
	79	.I tolower
	80	.I c
	81	is converted to lower case. Return value is undefined if not
	82	.I isupper(c).
	83	.TP
	84	.I toupper
	85	.I c
	86	is converted to upper case. Return value is undefined if not
	87	.I islower(c).
	88	.TP
	89	.I toascii
	90	.I c
	91	is converted to be a valid ascii character.
ec009048 KM	92	.SH "SEE ALSO"
ec009048 KM	93	ascii(7)