towupper(3) [osf1 man page]

towlower(3)						     Library Functions Manual						       towlower(3)

NAME

       towlower, towupper - Convert uppercase and lowercase wide characters

LIBRARY

       Standard C Library (libc)

SYNOPSIS

       #include <wctype.h>

       wint_t towlower (      wint_t wc);

       wint_t towupper (      wint_t wc);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       towlower(), towupper(): XSH5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Specifies the wide character to convert.

DESCRIPTION

       The  towlower()	function converts the uppercase wide character specified by the wc parameter into the corresponding lowercase wide charac-
       ter. The towupper() function converts the lowercase wide character specified by the wc parameter  into  the  corresponding  uppercase  wide
       character. The behavior of the towlower() and towupper() functions are affected by the LC_CTYPE category of the program's locale.

       [Tru64  UNIX]  In  a locale where case conversion information is not defined, these functions determine the case of characters according to
       the rules of the C locale.

RETURN VALUES

       In the towlower() function, if the wc parameter contains an uppercase wide character that has a	corresponding  lowercase  wide	character,
       that wide character is returned. Otherwise, the wc parameter is returned unchanged.

       In the towupper() function, if the wc parameter contains a lowercase wide character that has a corresponding uppercase wide character, that
       wide character is returned. Otherwise, the wc parameter is returned unchanged.

RELATED INFORMATION

       Functions: conv(3), setlocale(3), towctrans(3), wctrans(3)

       Standards: standards(5) delim off

																       towlower(3)

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

NAME

       towlower, towlower_l - convert a wide character to lowercase

SYNOPSIS

       #include <wctype.h>

       wint_t towlower(wint_t wc);

       wint_t towlower_l(wint_t wc, locale_t locale);

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

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

DESCRIPTION

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

       The  towlower_l() function performs the same task, but performs the conversion based on the character type information in the locale speci-
       fied by locale.	The behavior of towlower_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 character in the locale or be the value WEOF.

RETURN VALUE

       If wc was convertible to lowercase, towlower() returns its lowercase equivalent; otherwise it returns wc.

VERSIONS

       The towlower_l() function first appeared in glibc 2.3.

ATTRIBUTES

       For an explanation of the terms used in this section, see attributes(7).

       +-------------+---------------+----------------+
       |Interface    | Attribute     | Value	      |
       +-------------+---------------+----------------+
       |towlower()   | Thread safety | MT-Safe locale |
       +-------------+---------------+----------------+
       |towlower_l() | Thread safety | MT-Safe	      |
       +-------------+---------------+----------------+
CONFORMING TO

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

       towlower_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 characters, because Unicode knows about three cases: upper, lower and
       title case.

SEE ALSO

       iswlower(3), towctrans(3), towupper(3), locale(7)

COLOPHON

       This page is part of release 4.15 of the Linux man-pages project.  A description of the project, information about reporting bugs, and  the
       latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.

GNU
								    2017-09-15							       TOWLOWER(3)