Manual Pages for UNIX Operating System command usage for man wctrans

Standard C Library Functions                          wctrans(3C)



NAME
     wctrans - define character mapping

SYNOPSIS
     #include 

     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:












SunOS 5.11          Last change: 14 Aug 2002                    1






Standard C Library Functions                          wctrans(3C)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     setlocale(3C), towctrans(3C), attributes(5), standards(5)








































SunOS 5.11          Last change: 14 Aug 2002                    2