Name

btowc, wctob - convert between wide and single-byte characters

Library

Standard C Library (libc, -lc)

Synopsis

#include <wchar.h>

wint_t
btowc(int c);

int
wctob(wint_t c);

Description

The btowc() function converts a single-byte character into a corresponding wide character. If the character is EOF or not valid in the initial shift state, btowc() returns WEOF.

The wctob() function converts a wide character into a corresponding single-byte character. If the wide character is WEOF or not able to be represented as a single byte in the initial shift state, wctob() returns WEOF.

See Also

mbrtowc(3) , multibyte(3) , wcrtomb(3)

Standards

The btowc() and wctob() functions conform to IEEE Std 1003.1-2001 (``POSIX.1'').

History

The btowc() and wctob() functions first appeared in FreeBSD 5.0.

Table of Contents

• Name
• Library
• Synopsis
• Description
• See Also
• Standards
• History