btowc - convert single byte to wide character

The btowc() function converts c, interpreted as a multibyte sequence of length 1, starting in the initial shift state, to a wide character and returns it.
If c is EOF or not a valid multibyte sequence of length 1, the btowc() function returns WEOF.

Return Value

The btowc() function returns the wide character converted from the single byte c.
If c is EOF or not a valid multibyte sequence of length 1, it returns WEOF.

Notes

The behavior of btowc() depends on the LC_CTYPE category of the current locale.

Warning: This function should never be used.
It does not work for encodings which have state, and unnecessarily treats single bytes differently from multibyte sequences.
Use either mbtowc(3) or the thread-safe mbrtowc(3) instead.

See example

See also: https://github.com/ClnViewer/LibWchar2/blob/master/test/test_btowc.c

LibWchar2 information

Version: libwchar2 0.0.10

Date: Wed Aug 22 2018

Author: (c) PS 2018-2018

Manual author and license

Copyright: GNU Public License version 2. Manual license details