diff options
Diffstat (limited to 'man3/toupper.3')
-rw-r--r-- | man3/toupper.3 | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/man3/toupper.3 b/man3/toupper.3 new file mode 100644 index 000000000..50365002c --- /dev/null +++ b/man3/toupper.3 @@ -0,0 +1,69 @@ +.\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" License. +.\" Modified Sat Jul 24 17:45:39 1993 by Rik Faith (faith@cs.unc.edu) +.\" Modified 2000-02-13 by Nicolás Lichtmaier <nick@debian.org> +.TH TOUPPER 3 1993-04-04 "GNU" "Linux Programmer's Manual" +.SH NAME +toupper, tolower \- convert letter to upper or lower case +.SH SYNOPSIS +.nf +.B #include <ctype.h> +.sp +.BI "int toupper(int " "c" ); +.nl +.BI "int tolower(int " "c" ); +.fi +.SH DESCRIPTION +.B toupper() +converts the letter +.I c +to upper case, if possible. +.PP +.B tolower() +converts the letter +.I c +to lower case, if possible. +.PP +If +.I c +is not an unsigned char value, or EOF, the behaviour of these functions +is undefined. +.SH "RETURN VALUE" +The value returned is that of the converted letter, or +.I c +if the conversion was not possible. +.SH "CONFORMING TO" +ANSI C, BSD 4.3 +.SH BUGS +The details of what constitutes an uppercase or lowercase letter depend +on the current locale. For example, the default +.B """C""" +locale does not know about umlauts, so no conversion is done for them. +.PP +In some non - English locales, there are lowercase letters with no +corresponding uppercase equivalent; the German sharp s is one +example. +.SH "SEE ALSO" +.BR isalpha (3), +.BR setlocale (3), +.BR locale (7) |