getch-nolock-getwch-nolock.md

title	description	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords
_getch_nolock, _getwch_nolock	Learn more about: _getch_nolock, _getwch_nolock	4/2/2020	_getwch_nolock _getch_nolock _o__getch_nolock _o__getwch_nolock	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-conio-l1-1-0.dll	DLLExport	apiref	_getch_nolock getwch_nolock getch_nolock _getwch_nolock _gettch_nolock gettch_nolock	characters, getting from console _getwch_nolock function _getch_nolock function getwch_nolock function _gettch_nolock function console, reading from getch_nolock function gettch_nolock function

_getch_nolock, _getwch_nolock

Gets a character from the console without echo and without locking.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported in Universal Windows Platform apps.

Syntax

int _getch_nolock( void );
wint_t _getwch_nolock( void );

Return value

Returns the character read. There's no error return.

Remarks

_getch_nolock and _getwch_nolock are identical to _getch and _getchw except that they not protected from interference by other threads. They might be faster because they don't incur the overhead of locking out other threads. Use these functions only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.

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

Generic-text routine mappings

Tchar.h routine	_UNICODE and _MBCS not defined	_MBCS defined	_UNICODE defined
_gettch_nolock	_getch_nolock	_getch_nolock	_getwch_nolock

Requirements

Routine	Required header
_getch_nolock	<conio.h>
_getwch_nolock	<conio.h> or <wchar.h>

For more compatibility information, see Compatibility.

Example

// crt_getch_nolock.c
// compile with: /c
// This program reads characters from
// the keyboard until it receives a 'Y' or 'y'.

#include <conio.h>
#include <ctype.h>

int main( void )
{
   int ch;

   _cputs( "Type 'Y' when finished typing keys: " );
   do
   {
      ch = _getch_nolock();
      ch = toupper( ch );
   } while( ch != 'Y' );

   _putch_nolock( ch );
   _putch_nolock( '\r' );    // Carriage return
   _putch_nolock( '\n' );    // Line feed
}

abcdefy

Type 'Y' when finished typing keys: Y

See also

Console and port I/O
_getche, _getwche
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock