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

NAME

6       btowc - single byte to wide character conversion
7

SYNOPSIS

9       #include <stdio.h>
10       #include <wchar.h>
11
12       wint_t btowc(int c);
13
14

DESCRIPTION

16       The  btowc()  function  shall  determine  whether c constitutes a valid
17       (one-byte) character in the initial shift state.
18
19       The behavior of this function shall be affected by the  LC_CTYPE  cate‐
20       gory of the current locale.
21

RETURN VALUE

23       The  btowc()  function  shall  return WEOF if c has the value EOF or if
24       (unsigned char) c does not constitute a valid (one-byte)  character  in
25       the initial shift state.  Otherwise, it shall return the wide-character
26       representation of that character.
27

ERRORS

29       No errors are defined.
30
31       The following sections are informative.
32

EXAMPLES

34       None.
35

APPLICATION USAGE

37       None.
38

RATIONALE

40       None.
41

FUTURE DIRECTIONS

43       None.
44

SEE ALSO

46       wctob()  ,  the  Base  Definitions  volume   of   IEEE Std 1003.1-2001,
47       <wchar.h>
48

50       Portions  of  this text are reprinted and reproduced in electronic form
51       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
52       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
53       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
54       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
55       event of any discrepancy between this version and the original IEEE and
56       The  Open Group Standard, the original IEEE and The Open Group Standard
57       is the referee document. The original Standard can be  obtained  online
58       at http://www.opengroup.org/unix/online.html .
59
60
61
62IEEE/The Open Group                  2003                             BTOWC(P)
Impressum