Manpage of TOWLOWER

TOWLOWER

Section: Linux Programmer's Manual (3)
Updated: 2015-03-02
Index
 

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 wcis 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, wcis returned unchanged.

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

The argument wcmust be representable as a wchar_tand be a valid character in the locale or be the value WEOF.  

RETURN VALUE

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

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).
InterfaceAttributeValue
towlower() Thread safetyMT-Safe locale
towlower_l() Thread safetyMT-Safe
 

VERSIONS

The towlower_l() function first appeared in glibc 2.3.  

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_CTYPEcategory 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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ATTRIBUTES
VERSIONS
CONFORMING TO
NOTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 22:27:56 GMT, June 20, 2016