Man Pages

---

Back to Software Index  Manpage Top Level

.\” %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\” 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. .\” %%%LICENSE_END
.\"
.\” 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 TOWUPPER 3 2014-03-18 “GNU” “Linux Programmer’s Manual" .SH NAME
towupper, towupper_l \- convert a wide character to uppercase .SH SYNOPSIS
.nf
.B #include <wctype.h>
.sp
.BI “wint_t towupper(wint_t “ wc );

.BI “wint_t towupper_l(wint_t “ wc “, locale_t “ locale ); .fi
.sp
.in -4n

Feature Test Macro Requirements for glibc (see

.BR feature_test_macros (7)):
.in
.sp
.BR towupper_l ():
.PD 0
.RS 4
.TP

Since glibc 2.10:

_XOPEN_SOURCE\ >=\ 700
.TP

Before glibc 2.10:

_GNU_SOURCE
.RE
.PD
.SH DESCRIPTION

The

.BR towupper ()
function is the wide-character equivalent of the .BR toupper (3)
function.

If

.I wc
is a lowercase wide character,
and there exists an uppercase equivalent in the current locale, it returns the uppercase equivalent of
.IR wc .

In all other cases,

.I wc
is returned unchanged. function performs the same task,
but performs the conversion based on the character type information in the locale specified by
.IR locale .
is undefined if
.I locale
is the special locale object
.BR LC_GLOBAL_LOCALE
(see
.BR duplocale (3))
or is not a valid locale object handle. .I wc
must be representable as a
.IR wchar_t
and be a valid character in the locale or be the value .BR WEOF .
.SH RETURN VALUE

If

.I wc
was convertible to uppercase,
.BR towupper ()
returns its uppercase equivalent;
otherwise it returns
.IR wc .
.SH ATTRIBUTES
.SS Multithreading (see pthreads(7) )
.BR towupper ()
function is thread-safe with exceptions.

It can be safely used in multithreaded applications, as long as

.BR setlocale (3)
is not called to change the locale during its execution. .\” FIXME . need a thread-safety statement about towupper_l() .SH VERSIONS
function first appeared in glibc 2.3.
.SH CONFORMING TO
.BR towupper ():

C99, Posix.1-2001 (xsi);

present as an XSI extension in POSIX.1-2008, but marked obsolete.

.BR towupper_l ():

Posix.1-2008.

.SH NOTES
.B LC_CTYPE
category of the locale.
.PP
because Unicode knows about three cases: upper, lower and title case. .SH SEE ALSO
.BR iswupper (3),
.BR towctrans (3),
.BR towlower (3),
.BR locale (7)
.SH COLOPHON

This page is part of release 3.78 of the Linux

.I man-pages
project.

A description of the project,

information about reporting bugs,
and the latest version of this page,
can be found at

Table of Contents

• Feature Test Macro Requirements for glibc (see
• Since glibc 2.10:
• Before glibc 2.10:
• The
• If
• In all other cases,
• If
• It can be safely used in multithreaded applications, as long as
• C99, Posix.1-2001 (xsi);
• Posix.1-2008.
• This page is part of release 3.78 of the Linux
• A description of the project,