Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

towctrans(3) Guardian Native C Library Calls Reference Manual
NAME
towctrans - Character transliteration function
LIBRARY
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <wctype.h>
wint_t towctrans(wint_t wc, wctrans_t desc);
PARAMETERS
wc Wide-character to be transliterated
desc Describes the transliteration mapping.
DESCRIPTION
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.
The strings "tolower" and "toupper" are reserved for the standard mapping names. In the follow-
ing list, functions in the left column are equivalent to functions in the right column.
towlower(wc) towctrans(wc, wctrans("tolower"))
towupper(wc) towctrans(wc, wctrans("toupper"))
RETURN VALUES
If successful, the towctrans() function returns the mapped value of wc using the mapping
described by desc. Otherwise it returns wc unchanged.
ERRORS
If this condition occurs, the towctrans() function fails and sets errno to the corresponding value.
[EINVAL] The desc parameter contains an invalid transliteration descriptor.
RELATED INFORMATION
Functions: wctrans(3).
STANDARDS CONFORMANCE
The behavior of this function conforms to the ISO/IEC 9899:1999 standard.
7−42 Hewlett-Packard Company 527192-018