man3/towctrans.3

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