man3/towctrans.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" SPDX-License-Identifier: GPL-2.0-or-later
   4 .\"
   5 .\" References consulted:
   6 .\"   GNU glibc-2 source code and manual
   7 .\"   Dinkumware C library reference http://www.dinkumware.com/
   8 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
   9 .\"   ISO/IEC 9899:1999
  10 .\"
  11 .TH TOWCTRANS 3  2021-03-22 "Linux man-pages (unreleased)" "Linux Programmer's Manual"
  12 .SH NAME
  13 towctrans \- wide-character transliteration
  14 .SH LIBRARY
  15 Standard C library
  16 .RI ( libc ", " \-lc )
  17 .SH SYNOPSIS
  18 .nf
  19 .B #include <wctype.h>
  20 .PP
  21 .BI "wint_t towctrans(wint_t " wc ", wctrans_t " desc );
  22 .fi
  23 .SH DESCRIPTION
  24 If
  25 .I wc
  26 is a wide character, the
  27 .BR towctrans ()
  28 function
  29 translates it according to the transliteration descriptor
  30 .IR desc .
  31 If
  32 .I wc
  33 is
  34 .BR WEOF ,
  35 .B WEOF
  36 is returned.
  37 .PP
  38 .I desc
  39 must be a transliteration descriptor returned by
  40 the
  41 .BR wctrans (3)
  42 function.
  43 .SH RETURN VALUE
  44 The
  45 .BR towctrans ()
  46 function returns the translated wide character,
  47 or
  48 .B WEOF
  49 if
  50 .I wc
  51 is
  52 .BR WEOF .
  53 .SH ATTRIBUTES
  54 For an explanation of the terms used in this section, see
  55 .BR attributes (7).
  56 .ad l
  57 .nh
  58 .TS
  59 allbox;
  60 lbx lb lb
  61 l l l.
  62 Interface       Attribute       Value
  63 T{
  64 .BR towctrans ()
  65 T}      Thread safety   MT-Safe
  66 .TE
  67 .hy
  68 .ad
  69 .sp 1
  70 .SH STANDARDS
  71 POSIX.1-2001, POSIX.1-2008, C99.
  72 .SH NOTES
  73 The behavior of
  74 .BR towctrans ()
  75 depends on the
  76 .B LC_CTYPE
  77 category of the
  78 current locale.
  79 .SH SEE ALSO
  80 .BR towlower (3),
  81 .BR towupper (3),
  82 .BR wctrans (3)