Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > T

towctrans(3C)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

towctrans(), wctrans() — character transliteration

SYNOPSIS

#include <wctype.h>

wint_t towctrans(wint_t wc, wctrans_t desc);

wctrans_t wctrans(const char *charclass);

DESCRIPTION

towctrans()

The towctrans() function transliterates the wide-character code wc using the mapping described by desc. The current setting of the LC_CTYPE category should be the same as during the call to wctrans() that returned the value desc. If the value of desc is invalidated (that is, not obtained by a call to wctrans() or desc is invalidated by a subsequent call to setlocale() that has affected category LC_CTYPE, the result is undefined.

wctrans()

The wctrans() function is defined for valid character mapping names identified in the current locale. The charclass is a string identifying a generic character mapping name for which codeset-specific information is required. The following character mapping names are defined in all locales - "tolower" and "toupper". The function returns a value of type wctrans_t, which can be used as the second argument to subsequent calls of towctrans(). The wctrans() function determines values of wctrans_t according to the rules of the coded character set defined by character mapping information in the program's locale (category LC_CTYPE). The values returned by wctrans() are valid until a call to setlocale() that modifies the category LC_CTYPE.

APPLICATION USAGE

The strings "tolower" and "toupper" are reserved for the standard mapping names. In the table below, the functions in the left column are equivalent to the functions in the right column.

towlower(wc)

towctrans(wc, wctrans("tolower"))

towupper(wc)

towctrans(wc, wctrans("toupper"))

The prototypes of these functions are available to applications if they are:

a.

c99 conformant.

b.

Compiled with -D_XOPEN_SOURCE macro with a value >=500.

c.

Compiled with -D_POSIX_C_SOURCE macro with a value >= 200112.

RETURN VALUE

If successful, the towctrans() function returns the mapped value of wc using the mapping described by desc. Otherwise it returns wc unchanged.

The wctrans() function returns (wchar_t)0 if the given character mapping name is not valid for the current locale (category LC_CTYPE), otherwise it returns a non-zero object of type wctrans_t that can be used in calls to towctrans().

ERRORS

The towctrans() function may fail if:

EINVAL

desc contains an invalid transliteration descriptor.

The wctrans() function may fail if:

EINVAL

The character mapping name pointed to by charclass is not valid in the current locale.

AUTHOR

towctrans(), wctrans() were developed by HP and Mitsubishi Electric Corporation.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.