[thirdparty/man-pages.git] / man3 / towlower.3

.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.TH TOWLOWER 3  1999-07-25 "GNU" "Linux Programmer's Manual"
.SH NAME
towlower \- convert a wide character to lowercase
.SH SYNOPSIS
.nf
.B #include <wctype.h>
.sp
.BI "wint_t towlower(wint_t " wc );
.fi
.SH DESCRIPTION
The
.BR towlower ()
function is the wide-character equivalent of the
.BR tolower (3)
function.
If \fIwc\fP is a wide character, it is converted to
lowercase.
Characters which do not have case are returned unchanged.
If \fIwc\fP is \fBWEOF\fP, \fBWEOF\fP is returned.
.SH RETURN VALUE
The
.BR towlower ()
function returns the lowercase equivalent of \fIwc\fP,
or \fBWEOF\fP if \fIwc\fP is \fBWEOF\fP.
.SH CONFORMING TO
C99.
.SH NOTES
The behavior of
.BR towlower ()
depends on the
.B LC_CTYPE
category of the
current locale.
.PP
This function is not very appropriate for dealing with Unicode characters,
because Unicode knows about three cases: upper, lower and title case.
.SH SEE ALSO
.BR iswlower (3),
.BR towctrans (3),
.BR towupper (3)
Commit	Line	Data
fea681da MK	1	.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
	2	.\"
	3	.\" This is free documentation; you can redistribute it and/or
	4	.\" modify it under the terms of the GNU General Public License as
	5	.\" published by the Free Software Foundation; either version 2 of
	6	.\" the License, or (at your option) any later version.
	7	.\"
	8	.\" References consulted:
	9	.\" GNU glibc-2 source code and manual
	10	.\" Dinkumware C library reference http://www.dinkumware.com/
008f1ecc	11	.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
fea681da MK	12	.\" ISO/IEC 9899:1999
	13	.\"
	14	.TH TOWLOWER 3 1999-07-25 "GNU" "Linux Programmer's Manual"
	15	.SH NAME
	16	towlower \- convert a wide character to lowercase
	17	.SH SYNOPSIS
	18	.nf
	19	.B #include <wctype.h>
	20	.sp
	21	.BI "wint_t towlower(wint_t " wc );
	22	.fi
	23	.SH DESCRIPTION
60a90ecd MK	24	The
	25	.BR towlower ()
	26	function is the wide-character equivalent of the
	27	.BR tolower (3)
	28	function.
c13182ef MK	29	If \fIwc\fP is a wide character, it is converted to
	30	lowercase.
	31	Characters which do not have case are returned unchanged.
f3fef736	32	If \fIwc\fP is \fBWEOF\fP, \fBWEOF\fP is returned.
47297adb	33	.SH RETURN VALUE
60a90ecd MK	34	The
	35	.BR towlower ()
	36	function returns the lowercase equivalent of \fIwc\fP,
f3fef736	37	or \fBWEOF\fP if \fIwc\fP is \fBWEOF\fP.
47297adb	38	.SH CONFORMING TO
68e1685c	39	C99.
fea681da	40	.SH NOTES
d9bfdb9c	41	The behavior of
60a90ecd	42	.BR towlower ()
1274071a MK	43	depends on the
	44	.B LC_CTYPE
	45	category of the
fea681da MK	46	current locale.
	47	.PP
	48	This function is not very appropriate for dealing with Unicode characters,
	49	because Unicode knows about three cases: upper, lower and title case.
47297adb	50	.SH SEE ALSO
e37e3282 MK	51	.BR iswlower (3),
	52	.BR towctrans (3),
	53	.BR towupper (3)