netbsd man page for wctrans

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

NAME
     wctrans -- get character mapping identifier by name

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <wctype.h>

     wctrans_t
     wctrans(const char *charmap);

DESCRIPTION
     The wctrans() function returns a character mapping identifier corresponding to the locale-specific character mapping name charmap.  This
     identifier can be used on the subsequent calls of towctrans().  The following names are defined in all locales:

	   tolower toupper

     The behaviour of wctrans() is affected by the LC_CTYPE category of the current locale.

RETURN VALUES
     wctrans() returns:

     0		   If the string charmap does not corresponding to a valid character mapping name.

     non-zero	   A character mapping identifier corresponding to charmap.

     Note: wctype_t is a scalar type, e.g., a pointer.

ERRORS
     No errors are defined.

SEE ALSO
     iswctype(3), setlocale(3), wctype(3)

STANDARDS
     The towctrans() function conforms to ISO/IEC 9899/AMD1:1995 (``ISO C90, Amendment 1'').

BSD
								   March 4, 2003							       BSD