WCTRANS(3)               BSD Library Functions Manual               WCTRANS(3)

NAME
     towctrans, wctrans, towctransl, wctransl -- wide character mapping
     functions

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##include <>

     wintt
     towctrans(wintt wc, wctranst desc);

     wctranst
     wctrans(const char *charclass);

     ##include <>

     wintt
     towctransl(wintt wc, wctranst desc, localet loc);

     wctranst
     wctransl(const char *charclass, localet loc);

DESCRIPTION
     The wctrans() function returns a value of type wctranst which represents
     the requested wide character mapping operation and may be used as the
     second argument for calls to towctrans().

     The following character mapping names are recognised:

           tolower    toupper

     The towctrans() function transliterates the wide character wc according
     to the mapping described by desc.

     While the towctrans() and wctrans() functions use the current locale, the
     towctransl() and wctransl() functions may be passed locales directly.
     See xlocale(3) for more information.

RETURN VALUES
     The towctrans() function returns the transliterated character if success-
     ful, otherwise it returns the character unchanged and sets errno.

     The wctrans() function returns non-zero if successful, otherwise it
     returns zero and sets errno.

EXAMPLES
     Reimplement towupper() in terms of towctrans() and wctrans():

           wintt
           mytowupper(wintt wc)
           {
                   return (towctrans(wc, wctrans("toupper")));
           }

ERORS
     The towctrans() function will fail if:

     [EINVAL]           The supplied desc argument is invalid.

     The wctrans() function will fail if:

     [EINVAL]           The requested mapping name is invalid.

SEE ALSO
     tolower(3), toupper(3), wctype(3), xlocale(3)

STANDARDS
     The towctrans() and wctrans() functions conform to IE Std 1003.1-2001
     (``POSIX.1'').

HISTORY
     The towctrans() and wctrans() functions first appeared in FreeBSD 5.0.

BSD                             October 3, 2002                            BSD