]> git.ipfire.org Git - thirdparty/man-pages.git/blame - man3/toascii.3
getutent.3: tfix
[thirdparty/man-pages.git] / man3 / toascii.3
CommitLineData
bf5a7247 1.\" Copyright (c) 1995 by Jim Van Zandt <jrv@vanzandt.mv.com>
fea681da 2.\"
93015253 3.\" %%%LICENSE_START(VERBATIM)
fea681da
MK
4.\" Permission is granted to make and distribute verbatim copies of this
5.\" manual provided the copyright notice and this permission notice are
6.\" preserved on all copies.
7.\"
8.\" Permission is granted to copy and distribute modified versions of this
9.\" manual under the conditions for verbatim copying, provided that the
10.\" entire resulting derived work is distributed under the terms of a
11.\" permission notice identical to this one.
c13182ef 12.\"
fea681da
MK
13.\" Since the Linux kernel and libraries are constantly changing, this
14.\" manual page may be incorrect or out-of-date. The author(s) assume no
15.\" responsibility for errors or omissions, or for damages resulting from
16.\" the use of the information contained herein. The author(s) may not
17.\" have taken the same level of care in the production of this manual,
18.\" which is licensed free of charge, as they might when working
19.\" professionally.
c13182ef 20.\"
fea681da
MK
21.\" Formatted or processed versions of this manual, if unaccompanied by
22.\" the source, must acknowledge the copyright and authors of this work.
4b72fb64 23.\" %%%LICENSE_END
fea681da
MK
24.\"
25.\" Added BUGS section, aeb, 950919
26.\"
97986708 27.TH TOASCII 3 2016-03-15 "GNU" "Linux Programmer's Manual"
fea681da
MK
28.SH NAME
29toascii \- convert character to ASCII
30.SH SYNOPSIS
31.nf
32.B #include <ctype.h>
68e4db0a 33.PP
fea681da
MK
34.BI "int toascii(int " "c" );
35.fi
68e4db0a 36.PP
cc4615cc
MK
37.in -4n
38Feature Test Macro Requirements for glibc (see
39.BR feature_test_macros (7)):
40.in
68e4db0a 41.PP
cc4615cc 42.BR toascii ():
d59161f9
MK
43_XOPEN_SOURCE
44 || /* Glibc since 2.19: */ _DEFAULT_SOURCE
45 || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
fea681da 46.SH DESCRIPTION
60a90ecd 47.BR toascii ()
c6fa0841
MK
48converts
49.I c
50to a 7-bit
51.I "unsigned char"
52value that fits into the ASCII character set, by clearing the
fea681da 53high-order bits.
47297adb 54.SH RETURN VALUE
fea681da 55The value returned is that of the converted character.
9a677ed6 56.SH ATTRIBUTES
04be2a99
PH
57For an explanation of the terms used in this section, see
58.BR attributes (7).
59.TS
60allbox;
61lb lb lb
62l l l.
63Interface Attribute Value
64T{
9a677ed6 65.BR toascii ()
04be2a99
PH
66T} Thread safety MT-Safe
67.TE
47297adb 68.SH CONFORMING TO
68e1685c 69SVr4, BSD, POSIX.1-2001.
2045a15f
MK
70POSIX.1-2008 marks
71.BR toascii ()
4b9e7a88 72as obsolete,
ec3ca30f 73noting that it cannot be used portably in a localized application.
fea681da
MK
74.SH BUGS
75Many people will be unhappy if you use this function.
76This function will convert accented letters into random characters.
47297adb 77.SH SEE ALSO
fea681da
MK
78.BR isascii (3),
79.BR tolower (3),
80.BR toupper (3)