Return to toascii.3 CVS log

Up to [cvs.NetBSD.org] / src / lib / libc / gen

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.