1btowc(3C)                Standard C Library Functions                btowc(3C)
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  determines  whether c constitutes a valid (one-
17       byte) character in the initial shift state.
18
19
20       The behavior of this function is affected by the LC_CTYPE  category  of
21       the current locale.  See environ(5).
22

RETURN VALUES

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

ERRORS

30       No errors are defined.
31

ATTRIBUTES

33       See attributes(5) for descriptions of the following attributes:
34
35
36
37
38       ┌─────────────────────────────┬─────────────────────────────┐
39       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
40       ├─────────────────────────────┼─────────────────────────────┤
41       │Interface Stability          │Standard                     │
42       ├─────────────────────────────┼─────────────────────────────┤
43       │MT-Level                     │MT-Safe with exceptions      │
44       └─────────────────────────────┴─────────────────────────────┘
45

SEE ALSO

47       setlocale(3C), wctob(3C), attributes(5), environ(5), standards(5)
48

NOTES

50       The btowc() function can be used safely in multithreaded  applications,
51       as long as setlocale(3C) is not being called to change the locale.
52
53
54
55SunOS 5.11                        24 Jul 2002                        btowc(3C)
Impressum