BTOWC(3C) Standard C Library Functions BTOWC(3C)
btowc, btowc_l - single-byte to wide-character conversion
#include <stdio.h>
#include <wchar.h>
wint_t btowc(int c);
#include <stdio.h>
#include <wchar.h>
#include <xlocale.h>
wint_t btowc_l(int c, locale_t loc);
The btowc() and btowc_l()functions determines whether c constitutes a
valid (one-byte) character in the initial shift state.
The behavior of btowc() is affected by the LC_CTYPE category of the
current locale. See environ(7). The function btowc_l() does not use
the current locale, and instead operates on the locale specified by
loc.
The btowc() function returns WEOF if c has the value EOF or if
(unsigned char)c does not constitute a valid (one-byte) character in
the initial shift state. Otherwise, it returns the wide-character
representation of that character.
No errors are defined.
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | See below. |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
The btowc() function is Standard. The btowc_l() function is
Uncommitted.
newlocale(3C), setlocale(3C), uselocale(3C), wctob(3C),
attributes(7), environ(7), standards(7)
June 27, 2014 BTOWC(3C)
NAME
btowc, btowc_l - single-byte to wide-character conversion
SYNOPSIS
#include <stdio.h>
#include <wchar.h>
wint_t btowc(int c);
#include <stdio.h>
#include <wchar.h>
#include <xlocale.h>
wint_t btowc_l(int c, locale_t loc);
DESCRIPTION
The btowc() and btowc_l()functions determines whether c constitutes a
valid (one-byte) character in the initial shift state.
The behavior of btowc() is affected by the LC_CTYPE category of the
current locale. See environ(7). The function btowc_l() does not use
the current locale, and instead operates on the locale specified by
loc.
RETURN VALUES
The btowc() function returns WEOF if c has the value EOF or if
(unsigned char)c does not constitute a valid (one-byte) character in
the initial shift state. Otherwise, it returns the wide-character
representation of that character.
ERRORS
No errors are defined.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | See below. |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
The btowc() function is Standard. The btowc_l() function is
Uncommitted.
SEE ALSO
newlocale(3C), setlocale(3C), uselocale(3C), wctob(3C),
attributes(7), environ(7), standards(7)
June 27, 2014 BTOWC(3C)