1TOWCTRANS(P)               POSIX Programmer's Manual              TOWCTRANS(P)
2
3
4

NAME

6       towctrans - wide-character transliteration
7

SYNOPSIS

9       #include <wctype.h>
10
11       wint_t towctrans(wint_t wc, wctrans_t desc);
12
13

DESCRIPTION

15       The towctrans() function shall transliterate the wide-character code wc
16       using the mapping  described  by  desc.  The  current  setting  of  the
17       LC_CTYPE  category  should  be the same as during the call to wctrans()
18       that returned the value desc.    If the value of desc is invalid  (that
19       is,  not  obtained  by  a call to wctrans() or desc is invalidated by a
20       subsequent call to setlocale() that has affected category  LC_CTYPE  ),
21       the result is unspecified.
22
23       An  application  wishing to check for error situations should set errno
24       to 0 before calling towctrans(). If errno is  non-zero  on  return,  an
25       error has occurred.
26

RETURN VALUE

28       If  successful,  the towctrans() function shall return the mapped value
29       of wc using the mapping described by desc. Otherwise, it  shall  return
30       wc unchanged.
31

ERRORS

33       The towctrans() function may fail if:
34
35       EINVAL desc contains an invalid transliteration descriptor.
36
37
38       The following sections are informative.
39

EXAMPLES

41       None.
42

APPLICATION USAGE

44       The  strings "tolower" and "toupper" are reserved for the standard map‐
45       ping names. In the table below, the functions in the  left  column  are
46       equivalent to the functions in the right column.
47
48
49              towlower(wc)    towctrans(wc, wctrans("tolower"))
50              towupper(wc)    towctrans(wc, wctrans("toupper"))
51

RATIONALE

53       None.
54

FUTURE DIRECTIONS

56       None.
57

SEE ALSO

59       towlower()  ,  towupper()  , wctrans() , the Base Definitions volume of
60       IEEE Std 1003.1-2001, <wctype.h>
61

63       Portions of this text are reprinted and reproduced in  electronic  form
64       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
65       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
66       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
67       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
68       event of any discrepancy between this version and the original IEEE and
69       The Open Group Standard, the original IEEE and The Open Group  Standard
70       is  the  referee document. The original Standard can be obtained online
71       at http://www.opengroup.org/unix/online.html .
72
73
74
75IEEE/The Open Group                  2003                         TOWCTRANS(P)
Impressum