Index for Section 3

Alphabetical listing for W

Bottom of page

wctrans(3)
NAME
  wctrans - Map wide characters to a property

SYNOPSIS
  #include <wctype.h>

  wctrans_t wctrans(
	  const char *property );

LIBRARY
  Standard C Library (libc)

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  wctrans(): XSH5.0

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

PARAMETERS
  property
      Identifies a definition that maps one wide character to another in the
      LC_TYPE category of a locale.

DESCRIPTION
  The wctrans() function constructs a wctrans_t value that maps wide
  characters in the current locale according to the specified property.
  Because all locales include ASCII letter characters through the Portable
  Character Set and because you can apply case conversion to ASCII letter
  charaters, two properties that are valid for all locales are toupper and
  tolower.

  After a successful call to the wctrans() function to map associated
  characters according to a specified property, you can call the towctrans()
  function to convert characters according to this property. Refer to the
  towctrans(3) reference page for an example that uses these functions.

RESTRICTIONS
  Currently, tolower and toupper are the only supported values for property.
  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
  If property identifies a wide-character mapping that is defined in the
  LC_CTYPE category of the current locale, the wctrans() function returns a
  nonzero value that is valid as the second argument of the towctrans()
  function; otherwise, the wctrans() function returns zero.

SEE ALSO
  Commands: localedef(1)

  Functions: iswctype(3), towctrans(3), wctype(3)

  Files: locale(4)

Index for Section 3

Alphabetical listing for W

Top of page