NAME
wctrans
—
get character mapping identifier by
name
LIBRARY
library “libc”
SYNOPSIS
#include
<wctype.h>
wctrans_t
wctrans
(const
char *charmap);
DESCRIPTION
Thewctrans
()
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, Amendment
1”).