BTOWC(3)

BTOWC(3) | Library Functions Manual | BTOWC(3)

# NAME

btowc — convert a single byte character to a wide character

# LIBRARY

Standard C Library (libc, -lc)

# SYNOPSIS

#include <wchar.h>

wint_t
btowc(int c);

# DESCRIPTION

The btowc() function converts a single byte character c in the initial shift state of the current locale to a corresponding wide character.

The behaviour of btowc() is affected by the LC_CTYPE category of the current locale.

# RETURN VALUES

The btowc() function returns:

WEOF
  If c is EOF or if (unsigned char) c does not correspond to a valid single byte character representation.
(otherwise)
  A wide character corresponding to c.

# ERRORS

No errors are defined.

# SEE ALSO

mbrtowc(3), setlocale(3), wctob(3)

# STANDARDS

The btowc() function conforms to ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”).

March 3, 2003 | NetBSD 7.1