towupper man page on Gentoo

Man page or keyword search:  
man Server   6889 pages
apropos Keyword Search (all sections)
Output format
Gentoo logo
[printable version]

TOWUPPER(3)		   Linux Programmer's Manual		   TOWUPPER(3)

NAME
       towupper, towupper_l - convert a wide character to uppercase

SYNOPSIS
       #include <wctype.h>

       wint_t towupper(wint_t wc);

       wint_t towupper_l(wint_t wc, locale_t locale);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       towupper_l():
	   Since glibc 2.10:
		  _XOPEN_SOURCE >= 700
	   Before glibc 2.10:
		  _GNU_SOURCE

DESCRIPTION
       The  towupper()	function is the wide-character equivalent of the toup‐
       per(3) function.	 If wc is a lowercase wide character, and there exists
       an uppercase equivalent in the current locale, it returns the uppercase
       equivalent of wc.  In all other cases, wc is returned unchanged.

       The towupper_l() function performs the same task, but performs the con‐
       version based on the character type information in the locale specified
       by locale.  The behavior of towupper_l() is undefined if locale is  the
       special	locale	object LC_GLOBAL_LOCALE (see duplocale(3)) or is not a
       valid locale object handle.

       The argument wc must be representable as a wchar_t and be a valid char‐
       acter in the locale or be the value WEOF.

RETURN VALUE
       If  wc  was  convertible to uppercase, towupper() returns its uppercase
       equivalent; otherwise it returns wc.

ATTRIBUTES
   Multithreading (see pthreads(7))
       The towupper() function is thread-safe  with  exceptions.   It  can  be
       safely  used  in multithreaded applications, as long as setlocale(3) is
       not called to change the locale during its execution.

VERSIONS
       The towupper_l() function first appeared in glibc 2.3.

CONFORMING TO
       towupper(): C99, POSIX.1-2001 (XSI); present as	an  XSI	 extension  in
       POSIX.1-2008, but marked obsolete.

       towupper_l(): POSIX.1-2008.

NOTES
       The behavior of these functions depends on the LC_CTYPE category of the
       locale.

       These functions are not very appropriate for dealing with Unicode char‐
       acters, because Unicode knows about three cases: upper, lower and title
       case.

SEE ALSO
       iswupper(3), towctrans(3), towlower(3), locale(7)

COLOPHON
       This page is part of release 3.63 of the Linux  man-pages  project.   A
       description  of	the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.

GNU				  2014-03-18			   TOWUPPER(3)
[top]

List of man pages available for Gentoo

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net