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)

towctrans(3)						     Library Functions Manual						      towctrans(3)

NAME

       towctrans - Converts a wide character according to a property defined in the current locale

LIBRARY

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

SYNOPSIS

       #include <wctype.h>

       wint_t towctrans(
	       wint_t wc,
	       wctrans_t conversion_handle );

STANDARDS

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

       towctrans(): ISO C

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

PARAMETERS

       Specifies  a  wide-character  value Calls the wctrans() function to return the wide character mapped to wc according to a valid property in
       the LC_CTYPE category of the current locale.

DESCRIPTION

       The towctrans() function maps a wide character to its counterpart value according to a specified property, for example, tolower or toupper.
       Before calling towctrans(), you must call wctrans() to determine if the property is valid for the current locale and to create a handle for
       the property map.  You then call towctrans() to return the wide-character value that corresponds to the wide-character value  specified	by
       wc.  The following example shows a call to towctrans() that returns the lowercase equivalent of wc: towctrans(wc, wctrans("tolower"));

       The preceding call is equivalent to the following call: towlower(wc);

       Unlike  the  towlower()	and  towupper() functions, which deal specifically with case mapping, the combination of wctrans() and towctrans()
       functions are designed to be used with other properties that can be defined in a locale.

RESTRICTIONS

       Currently, tolower and toupper are the only supported property values.  Defining additional properties in locales requires an extension	to
       the  localedef  utility.   The rules for implementing this extension are not yet available in current issues of the industry standards that
       apply to this utility.

EXAMPLES

       The following example converts the value in from_wc to uppercase:

       wint_t	  from_wc, to_wc; wctrans_t  conv_handle;
	 .
	 .
	 .  conv_handle=wctrans("toupper"); to_wc=towctrans(from_wc,conv_handle);

RETURN VALUES

       The towctrans() function returns the mapped value of wc according to the mapping described by conversion_handle.  If EOF is encountered	or
       conversion_handle cannot be used, the function returns 0 (zero).

RELATED INFORMATION

       Functions: iswctype(3), towlower(3), wctrans(3), wctype(3)

       Files: locale(4) delim off

																      towctrans(3)