NAME    [Toc]    [Back]

     towctrans, wctrans -- wide character mapping functions

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <wctype.h>

     wint_t
     towctrans(wint_t wc, wctrans_t desc);

     wctrans_t
     wctrans(const char *charclass);

DESCRIPTION    [Toc]    [Back]

     The wctrans() function returns a value of type wctrans_t 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.

RETURN VALUES    [Toc]    [Back]

     The towctrans() function returns the transliterated character if successful,
 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    [Toc]    [Back]

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

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

ERRORS    [Toc]    [Back]

     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    [Toc]    [Back]

     tolower(3), toupper(3), wctype(3)

STANDARDS    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

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


FreeBSD 5.2.1			October 3, 2002 		 FreeBSD 5.2.1