btowc.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: btowc	btowc	4/2/2020	btowc _o_btowc	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-convert-l1-1-0.dll	DLLExport	apiref	btowc	btowc function	99a46e02-6f86-4569-af79-5feca012add8

btowc

Determine whether an integer represents a valid single-byte character in the initial shift state.

Syntax

wint_t btowc(
   int character
);

Parameters

character
Integer to test.

Return value

Returns the wide-character representation of the character if the integer represents a valid single-byte character in the initial shift state. Returns WEOF if the integer is EOF or isn't a valid single-byte character in the initial shift state. The output of this function is affected by the current LC_TYPE locale.

Remarks

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Routine	Required header
btowc	<stdio.h> or <wchar.h>

For more compatibility information, see Compatibility.

See also

mbtowc, _mbtowc_l