Annotation of src/lib/libc/gen/toascii.3, Revision 1.13
1.13 ! jruoho 1: .\" $NetBSD: toascii.3,v 1.12 2008/04/17 16:41:00 apb Exp $
1.2 mikel 2: .\"
1.1 mikel 3: .\" Copyright (c) 1993
4: .\" The Regents of the University of California. All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
1.8 agc 14: .\" 3. Neither the name of the University nor the names of its contributors
1.1 mikel 15: .\" may be used to endorse or promote products derived from this software
16: .\" without specific prior written permission.
17: .\"
18: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28: .\" SUCH DAMAGE.
29: .\"
30: .\" @(#)toascii.3 8.1 (Berkeley) 6/4/93
31: .\"
1.13 ! jruoho 32: .Dd April 30, 2010
1.1 mikel 33: .Dt TOASCII 3
34: .Os
35: .Sh NAME
36: .Nm toascii
37: .Nd convert a byte to 7-bit ASCII
1.4 perry 38: .Sh LIBRARY
39: .Lb libc
1.1 mikel 40: .Sh SYNOPSIS
1.7 wiz 41: .In ctype.h
1.1 mikel 42: .Ft int
43: .Fn toascii "int c"
44: .Sh DESCRIPTION
45: The
46: .Fn toascii
1.11 cbiere 47: function returns the argument with all but the lower 7 bits cleared.
1.1 mikel 48: .Sh RETURN VALUES
49: The
50: .Fn toascii
51: function always returns a valid ASCII character.
1.12 apb 52: The result is a non-negative integer in the
53: range from 0 to 127, inclusive.
1.1 mikel 54: .Sh SEE ALSO
1.10 rillig 55: .Xr ctype 3 ,
1.1 mikel 56: .Xr isalnum 3 ,
57: .Xr isalpha 3 ,
1.5 wiz 58: .Xr isascii 3 ,
1.1 mikel 59: .Xr iscntrl 3 ,
60: .Xr isdigit 3 ,
61: .Xr isgraph 3 ,
62: .Xr islower 3 ,
63: .Xr isprint 3 ,
64: .Xr ispunct 3 ,
65: .Xr isspace 3 ,
66: .Xr isupper 3 ,
67: .Xr isxdigit 3 ,
1.5 wiz 68: .Xr stdio 3 ,
1.1 mikel 69: .Xr tolower 3 ,
70: .Xr toupper 3 ,
71: .Xr ascii 7
1.3 kleink 72: .Sh STANDARDS
73: The
1.9 wiz 74: .Fn toascii
1.3 kleink 75: function conforms to
1.13 ! jruoho 76: .St -xpg4
! 77: and
! 78: .St -p1003.1-2001 .
! 79: The
! 80: .St -p1003.1-2008
! 81: revision however marked it as obsolete, noting that
! 82: .Fn toascii
! 83: cannot be used portably in a localized application.
CVSweb <webmaster@jp.NetBSD.org>