towctrans man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

towctrans(3)							  towctrans(3)

NAME
       towctrans - Convert a wide character according to a property defined in
       the current locale

SYNOPSIS
       #include <wctype.h>

       wint_t towctrans(
	       wint_t wc,
	       wctrans_t conversion_handle );

LIBRARY
       Standard C Library (libc)

STANDARDS
       Interfaces documented on this reference page conform to industry	 stan‐
       dards as follows:

       towctrans(): ISO C

       Refer  to  the  standards(5)  reference page for more information about
       industry standards and associated tags.

PARAMETERS
       Specifies a wide-character value Calls the wctrans() function to return
       the  wide  character  mapped to wc according to a valid property in the
       LC_CTYPE category of the current locale.

DESCRIPTION
       The towctrans() function maps a wide character to its counterpart value
       according  to  a	 specified  property, for example, tolower or toupper.
       Before calling towctrans(), you must call wctrans() to determine if the
       property is valid for the current locale and to create a handle for the
       property map. You then call towctrans() to  return  the	wide-character
       value that corresponds to the wide-character value specified by wc. The
       following example shows a call to towctrans() that returns  the	lower‐
       case equivalent of wc:

       towctrans(wc, wctrans("tolower"));

       The preceding call is equivalent to the following call:

       towlower(wc);

       Unlike the towlower() and towupper() functions, which deal specifically
       with case mapping, the combination of wctrans() and  towctrans()	 func‐
       tions are designed to be used with other properties that can be defined
       in a locale.

RESTRICTIONS
       Currently, tolower and toupper are the only supported property  values.
       Defining	 additional properties in locales requires an extension to the
       localedef utility.  The rules for implementing this extension  are  not
       yet available in current issues of the industry standards that apply to
       this utility.

RETURN VALUES
       The towctrans() function returns the mapped value of  wc	 according  to
       the  mapping  described	by conversion_handle. If EOF is encountered or
       conversion_handle cannot be used, the function returns 0 (zero).

EXAMPLES
       The following example converts the value in from_wc to uppercase:

       wint_t	  from_wc, to_wc; wctrans_t  conv_handle;
	 .
	 .
	 .  conv_handle=wctrans("toupper");  to_wc=towctrans(from_wc,conv_han‐
       dle);

SEE ALSO
       Functions: iswctype(3), towlower(3), wctrans(3), wctype(3)

       Files: locale(4)

								  towctrans(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net