_putch, _putwch

Article
12/18/2017

The latest version of this topic can be found at _putch, _putwch.

Writes a character to the console.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW.

Syntax

  
      int _putch(  
int c   
);  
wint_t _putwch(  
   wchar_t c  
);

Parameters

c
Character to be output.

Return Value

Returns c if successful. If _putch fails, it returns EOF; if _putwch fails, it returns WEOF.

Remarks

These functions write the character c directly, without buffering, to the console. In Windows NT, _putwch writes Unicode characters using the current console locale setting.

The versions with the _nolock suffix are identical except that they are not protected from interference by other threads. For more information, see _putch_nolock, _putwch_nolock.

Generic-Text Routine Mappings

Tchar.h routine	_UNICODE and _MBCS not defined	_MBCS defined	_UNICODE defined
_puttch	`_putch`	`_putch`	_putwch

Requirements

Routine	Required header
`_putch`	<conio.h>
_putwch	<conio.h>

For more compatibility information, see Compatibility.

Libraries

All versions of the C run-time libraries.

Example

See the example for _getch.