Content-type: text/html Man page of wctrans

wctrans

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

NAME

wctrans - Maps wide characters to a property  

LIBRARY

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

SYNOPSIS

#include <wctype.h>

wctrans_t wctrans(
        const char *property);  

STANDARDS

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

wctrans(): ISO C

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

PARAMETERS

Identifies a definition that maps one wide character to another in the LC_TYPE category of a locale.  

DESCRIPTION

The wctrans() function constructs a wctrans_t value that maps wide characters in the current locale according to the specified property. Because all locales include ASCII letter characters through the Portable Character Set and because you can apply case conversion to ASCII letter charaters, two properties that are valid for all locales are toupper and tolower.

After a successful call to the wctrans() function to map associated characters according to a specified property, you can call the towctrans() function to convert characters according to this property. Refer to the towctrans(3) reference page for an example that uses these functions.  

RESTRICTIONS

Currently, tolower and toupper are the only supported values for property. 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.  

RETURN VALUES

If property identifies a wide-character mapping that is defined in the LC_CTYPE category of the current locale, the wctrans() function returns a nonzero value that is valid as the second argument of the towctrans() function; otherwise, the wctrans() function returns zero.  

RELATED INFORMATION

Commands: localedef(1)

Functions: iswctype(3), towctrans(3), wctype(3)

Files: locale(4) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RESTRICTIONS
RETURN VALUES
RELATED INFORMATION

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