Content-type: text/html Man page of towlower

towlower

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

towlower, towupper - Convert uppercase and lowercase wide characters  

LIBRARY

Standard C Library (libc.so, libc.a)  

SYNOPSIS

#include <wctype.h>

wint_t towlower (        wint_t wc);

wint_t towupper (        wint_t wc);

The XPG4 and XPG4-UNIX standards specify #include <wchar.h> in place of #include <wctype.h>, which is currently specified by the ISO C standard. Both #include statements are supported.  

STANDARDS

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

towlower(), towupper(): ISO C, XPG4

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 character. 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.

[Digital]  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


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:55 GMT, October 02, 2010