Annotation of src/lib/libc/gen/islower.3, Revision 1.10
1.10 ! wiz 1: .\" $NetBSD: islower.3,v 1.9 2002/07/10 14:37:14 yamt 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.
18: .\" 3. All advertising materials mentioning features or use of this software
19: .\" must display the following acknowledgement:
20: .\" This product includes software developed by the University of
21: .\" California, Berkeley and its contributors.
22: .\" 4. Neither the name of the University nor the names of its contributors
23: .\" may be used to endorse or promote products derived from this software
24: .\" without specific prior written permission.
25: .\"
26: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
27: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
30: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
35: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36: .\" SUCH DAMAGE.
37: .\"
1.4 cgd 38: .\" @(#)islower.3 5.2 (Berkeley) 6/29/91
1.1 cgd 39: .\"
40: .Dd June 29, 1991
41: .Dt ISLOWER 3
42: .Os
43: .Sh NAME
44: .Nm islower
45: .Nd lower-case character test
1.5 perry 46: .Sh LIBRARY
47: .Lb libc
1.1 cgd 48: .Sh SYNOPSIS
1.10 ! wiz 49: .In ctype.h
1.1 cgd 50: .Ft int
51: .Fn islower "int c"
52: .Sh DESCRIPTION
53: The
54: .Fn islower
55: function tests for any lower-case letter
56: .\" or any of an
57: .\" implementation-defined set of characters
58: for which none of
59: .Xr iscntrl 3 ,
60: .Xr isdigit 3 ,
61: .Xr ispunct 3 ,
62: or
63: .Xr isspace 3
64: is true.
1.6 wiz 65: In the
1.1 cgd 66: .Em ``C''
67: locale,
68: .Fn islower
69: returns true only for the characters defined as lower-case letters.
70: .Sh RETURN VALUES
71: The
72: .Fn islower
73: macro returns zero if the character tests false and
74: returns non-zero if the character tests true.
75: .Sh SEE ALSO
76: .Xr isalnum 3 ,
77: .Xr isalpha 3 ,
1.3 jtc 78: .Xr isascii 3 ,
79: .Xr isblank 3 ,
1.1 cgd 80: .Xr iscntrl 3 ,
81: .Xr isdigit 3 ,
82: .Xr isgraph 3 ,
83: .Xr isprint 3 ,
84: .Xr ispunct 3 ,
85: .Xr isspace 3 ,
86: .Xr isupper 3 ,
87: .Xr isxdigit 3 ,
1.7 wiz 88: .Xr stdio 3 ,
1.1 cgd 89: .Xr toascii 3 ,
90: .Xr tolower 3 ,
91: .Xr toupper 3 ,
92: .Xr ascii 7
93: .Sh STANDARDS
94: The
95: .Fn islower
96: function conforms to
97: .St -ansiC .
1.9 yamt 98: .Sh CAVEATS
99: The argument to
100: .Fn islower
101: must be
102: .Dv EOF
103: or representable as an
104: .Li unsigned char ;
105: otherwise, the result is undefined.
CVSweb <webmaster@jp.NetBSD.org>