towctrans(3C)															     towctrans(3C)

NAME

       towctrans(), wctrans() - character transliteration

SYNOPSIS

DESCRIPTION

       The	      function transliterates the wide-character code wc using the mapping described by desc.  The current setting of the category
		      should be the same as during the call to that returned the value desc.  If the value of desc is invalidated  (that  is,  not
		      obtained by a call to or desc is invalidated by a subsequent call to that has affected category the result is undefined.

       The	      function is defined for valid character mapping names identified in the current locale.  The charclass is a string identify-
		      ing a generic character mapping name for which codeset-specific information is required.	The  following	character  mapping
		      names  are  defined in all locales - "tolower" and "toupper".  The function returns a value of type which can be used as the
		      second argument to subsequent calls of The function determines values of according to the rules of the coded  character  set
		      defined  by character mapping information in the program's locale (category The values returned by are valid until a call to
		      that modifies the category

APPLICATION USAGE

       The strings "tolower" and "toupper" are reserved for the standard mapping names.  In the table below, the functions in the left column  are
       equivalent to the functions in the right column.

	      The prototypes of these functions are available to applications
	      if they are:

	      a. conformant.

	      b. Compiled with macro with a value >=500.

	      c. Compiled with macro with a value >= 200112.

RETURN VALUE

       If successful, the function returns the mapped value of wc using the mapping described by desc.	Otherwise it returns wc unchanged.

       The  function  returns  (wchar_t)0 if the given character mapping name is not valid for the current locale (category otherwise it returns a
       non-zero object of type that can be used in calls to

ERRORS

       The function may fail if:

	      desc	     contains an invalid transliteration descriptor.

       The function may fail if:

	      The character mapping name pointed to by
			     charclass is not valid in the current locale.

AUTHOR

       were developed by HP and Mitsubishi Electric Corporation.

SEE ALSO

       wconv(3C), thread_safety(5).

																     towctrans(3C)