Annotation of src/lib/libc/gen/isalpha.3, Revision 1.14
1.14 ! apb 1: .\" $NetBSD: isalpha.3,v 1.13 2007/01/18 08:35:07 rillig Exp $
1.4 cgd 2: .\"
1.1 cgd 3: .\" Copyright (c) 1991 The Regents of the University of California.
4: .\" All rights reserved.
5: .\"
6: .\" This code is derived from software contributed to Berkeley by
7: .\" the American National Standards Committee X3, on Information
8: .\" Processing Systems.
9: .\"
10: .\" Redistribution and use in source and binary forms, with or without
11: .\" modification, are permitted provided that the following conditions
12: .\" are met:
13: .\" 1. Redistributions of source code must retain the above copyright
14: .\" notice, this list of conditions and the following disclaimer.
15: .\" 2. Redistributions in binary form must reproduce the above copyright
16: .\" notice, this list of conditions and the following disclaimer in the
17: .\" documentation and/or other materials provided with the distribution.
1.11 agc 18: .\" 3. Neither the name of the University nor the names of its contributors
1.1 cgd 19: .\" may be used to endorse or promote products derived from this software
20: .\" without specific prior written permission.
21: .\"
22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32: .\" SUCH DAMAGE.
33: .\"
1.4 cgd 34: .\" @(#)isalpha.3 5.2 (Berkeley) 6/29/91
1.1 cgd 35: .\"
1.14 ! apb 36: .Dd April 17, 2008
1.1 cgd 37: .Dt ISALPHA 3
38: .Os
39: .Sh NAME
40: .Nm isalpha
41: .Nd alphabetic character test
1.5 perry 42: .Sh LIBRARY
43: .Lb libc
1.1 cgd 44: .Sh SYNOPSIS
1.10 wiz 45: .In ctype.h
1.6 wiz 46: .Ft int
1.1 cgd 47: .Fn isalpha "int c"
48: .Sh DESCRIPTION
49: The
50: .Fn isalpha
51: function tests for any character for which
52: .Xr isupper 3
53: or
54: .Xr islower 3
55: is true and
56: .\" , or any of an implementation-defined set of characters
57: for which none of
58: .Xr iscntrl 3 ,
59: .Xr isdigit 3 ,
60: .Xr ispunct 3 ,
61: or
62: .Xr isspace 3
63: is true.
1.6 wiz 64: In the
1.1 cgd 65: .Em ``C''
66: locale,
67: .Fn isalpha
68: returns true only for the characters for which
69: .Xr isupper 3
70: or
71: .Xr islower 3
72: is true.
73: .Sh RETURN VALUES
74: The
75: .Fn isalpha
1.12 rillig 76: function returns zero if the character tests false and
1.1 cgd 77: returns non-zero if the character tests true.
78: .Sh SEE ALSO
1.13 rillig 79: .Xr ctype 3 ,
1.3 jtc 80: .Xr isalnum 3 ,
1.1 cgd 81: .Xr isascii 3 ,
1.3 jtc 82: .Xr isblank 3 ,
1.1 cgd 83: .Xr iscntrl 3 ,
84: .Xr isdigit 3 ,
85: .Xr isgraph 3 ,
86: .Xr islower 3 ,
87: .Xr isprint 3 ,
88: .Xr ispunct 3 ,
89: .Xr isspace 3 ,
90: .Xr isupper 3 ,
91: .Xr isxdigit 3 ,
1.7 wiz 92: .Xr stdio 3 ,
1.1 cgd 93: .Xr toascii 3 ,
94: .Xr tolower 3 ,
95: .Xr toupper 3 ,
96: .Xr ascii 7
97: .Sh STANDARDS
98: The
99: .Fn isalpha
100: function conforms to
101: .St -ansiC .
1.9 yamt 102: .Sh CAVEATS
103: The argument to
104: .Fn isalpha
105: must be
106: .Dv EOF
107: or representable as an
1.14 ! apb 108: .Vt unsigned char ;
1.12 rillig 109: otherwise, the behavior is undefined.
1.14 ! apb 110: See the
! 111: .Sx CAVEATS
! 112: section of
! 113: .Xr ctype 3
! 114: for more details.
CVSweb <webmaster@jp.NetBSD.org>