Annotation of src/lib/libc/gen/toupper.3, Revision 1.17
1.17 ! apb 1: .\" $NetBSD: toupper.3,v 1.16 2007/01/18 08:35:07 rillig Exp $
1.3 cgd 2: .\"
1.1 cgd 3: .\" Copyright (c) 1989, 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.13 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.3 cgd 34: .\" @(#)toupper.3 5.2 (Berkeley) 6/29/91
1.1 cgd 35: .\"
1.17 ! apb 36: .Dd April 17, 2008
1.1 cgd 37: .Dt TOUPPER 3
38: .Os
39: .Sh NAME
40: .Nm toupper
41: .Nd lower case to upper case letter conversion
1.6 perry 42: .Sh LIBRARY
43: .Lb libc
1.1 cgd 44: .Sh SYNOPSIS
1.12 wiz 45: .In ctype.h
1.1 cgd 46: .Ft int
47: .Fn toupper "int c"
48: .Sh DESCRIPTION
49: The
50: .Fn toupper
1.9 wiz 51: function converts a lower-case letter to the corresponding
1.1 cgd 52: upper-case letter.
1.7 fair 53: .Sh RETURN VALUES
1.1 cgd 54: If the argument is a lower-case letter, the
55: .Fn toupper
56: function returns the corresponding upper-case letter if there is
57: one; otherwise the argument is returned unchanged.
1.9 wiz 58: .\" In the
1.1 cgd 59: .\" .Em ``C''
60: .\" locale,
61: .\" .Fn toupper
62: .\" maps only the characters for which
63: .\" .Xr islower
64: .\" is true to the corresponding characters for which
65: .\" .Xr isupper
1.8 wiz 66: .\" is true.
1.1 cgd 67: .Sh SEE ALSO
1.16 rillig 68: .Xr ctype 3 ,
1.1 cgd 69: .Xr isalnum 3 ,
70: .Xr isalpha 3 ,
1.7 fair 71: .Xr isascii 3 ,
1.1 cgd 72: .Xr iscntrl 3 ,
73: .Xr isdigit 3 ,
74: .Xr isgraph 3 ,
75: .Xr islower 3 ,
76: .Xr isprint 3 ,
77: .Xr ispunct 3 ,
78: .Xr isspace 3 ,
79: .Xr isupper 3 ,
80: .Xr isxdigit 3 ,
1.7 fair 81: .Xr stdio 3 ,
1.1 cgd 82: .Xr toascii 3 ,
83: .Xr ascii 7
84: .Sh STANDARDS
85: The
1.4 lukem 86: .Fn toupper
1.1 cgd 87: function conforms to
88: .St -ansiC .
1.14 wiz 89: .Sh CAVEATS
90: The argument to
91: .Fn toupper
92: must be
93: .Dv EOF
94: or representable as an
1.17 ! apb 95: .Vt unsigned char ;
1.15 rillig 96: otherwise, the behavior is undefined.
1.17 ! apb 97: See the
! 98: .Sx CAVEATS
! 99: section of
! 100: .Xr ctype 3
! 101: for more details.
CVSweb <webmaster@jp.NetBSD.org>