manpagez: man pages & more
man wctrans(3)
Home | html | info | man
wctrans(3)               BSD Library Functions Manual               wctrans(3)


NAME

     towctrans, towctrans_l, wctrans, wctrans_l -- wide character mapping
     functions


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <wctype.h>

     wint_t
     towctrans(wint_t wc, wctrans_t desc);

     wctrans_t
     wctrans(const char *charclass);

     #include <wctype.h>
     #include <xlocale.h>

     wint_t
     towctrans_l(wint_t wc, wctrans_t desc, locale_t loc);

     wctrans_t
     wctrans_l(const char *charclass, locale_t loc);


DESCRIPTION

     The wctrans() function returns a value of type wctrans_t, which repre-
     sents 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
     towctrans_l() and wctrans_l() 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():

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


ERRORS

     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 IEEE Std 1003.1-2001
     (``POSIX.1'').


HISTORY

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

BSD                             October 3, 2002                            BSD

Mac OS X 10.8 - Generated Sat Sep 1 06:29:02 CDT 2012
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.