wctrans(3C)




NAME

     wctrans - define character mapping


SYNOPSIS

     #include <wctype.h>

     wctrans_t wctrans(const char *charclass);


DESCRIPTION

     The wctrans() function is defined for valid  character  map-
     ping  names  identified in the current locale. The charclass
     is a string identifying a generic character mapping name for
     which codeset-specific information is required.  The follow-
     ing character mapping names are defined  in  all  locales  -
     "tolower" and "toupper".

     The function returns a value of type wctrans_t, which can be
     used   as   the  second  argument  to  subsequent  calls  of
     towctrans(3C). The wctrans() function determines  values  of
     wctrans_t  according to the rules of the coded character set
     defined by character mapping information  in  the  program's
     locale (category LC_CTYPE). The values returned by wctrans()
     are valid until a call to setlocale(3C)  that  modifies  the
     category LC_CTYPE.


RETURN VALUES

     The wctrans() function returns 0 if the given character map-
     ping  name  is  not  valid  for the current locale (category
     LC_CTYPE), otherwise it returns a non-zero  object  of  type
     wctrans_t that can be used in calls to towctrans(3C).


ERRORS

     The wctrans() function may fail if:

     EINVAL
           The character mapping name pointed to by charclass  is
           not valid in the current locale.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|


SEE ALSO

     setlocale(3C), towctrans(3C), attributes(5)


Man(1) output converted with man2html