WCTRANS(3) Library Functions Manual WCTRANS(3)
NAME
wctransget character mapping identifier by name
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <wctype.h>
wctrans_t
wctrans(const char *charmap);
DESCRIPTION
The wctrans() function returns a character mapping identifier corresponding to the locale-specific character mapping name charmap. This identifier can be used on the subsequent calls of towctrans(). The following names are defined in all locales:
tolower toupper
 
The behaviour of wctrans() is affected by the LC_CTYPE category of the current locale.
RETURN VALUES
wctrans() returns:
0
If the string charmap does not corresponding to a valid character mapping name.
non-zero
A character mapping identifier corresponding to charmap.
 
Note: wctype_t is a scalar type, e.g., a pointer.
ERRORS
No errors are defined.
SEE ALSO
STANDARDS
The towctrans() function conforms to ISO/IEC 9899/AMD1:1995 (“ISO C90”).