Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

towctrans(3) OSS 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−60 Hewlett-Packard Company 527187-017