WCTRANS(3) Linux Programmer's Manual WCTRANS(3)

NAME
       wctrans - wide-character translation mapping

SYNOPSIS
       #include 

       wctranst wctrans(const char *name);

DESCRIPTION
       The  wctranst type represents a mapping which can map a wide character
       to another wide character.  Its nature is implementation-dependent, but
       the  special  value  (wctranst) 0 denotes an invalid mapping.  Nonzero
       wctranst values can be passed to the towctrans(3) function to actually
       perform the wide-character mapping.

       The  wctrans()  function returns a mapping, given by its name.  The set
       of valid names depends on the LCCTYPE category of the current  locale,
       but the following names are valid in all locales.
         "tolower" - realizes the tolower(3) mapping
         "toupper" - realizes the toupper(3) mapping

RETURN VALUE
       The  wctrans()  function  returns  a  mapping descriptor if the name is
       valid.  Otherwise it returns (wctranst) 0.

ATTRIBUTES
       For  an  explanation  of  the  terms  used   in   this   section,   see
       attributes(7).

       ┌──────────┬───────────────┬────────────────┐
       │Interface │ Attribute     │ Value          │
       ├──────────┼───────────────┼────────────────┤
       │wctrans() │ Thread safety │ MT-Safe locale │
       └──────────┴───────────────┴────────────────┘
CONFORMING TO
       C99.

NOTES
       The  behavior of wctrans() depends on the LCCTYPE category of the cur‐
       rent locale.

SEE ALSO
       towctrans(3)

COLOPHON
       This page is part of release 3.53 of the Linux  man-pages  project.   A
       description  of  the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.



GNU                               1999-07-25                        WCTRANS(3)