_getche_nolock, _getwche_nolock

Gets a character from the console with 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 _getche_nolock( void );
wint_t _getwche_nolock( void );

Return value

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

Remarks

_getche_nolock and _getwche_nolock are identical to _getche and _getwche 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
_gettche_nolock	_getche_nolock	_getch_nolock	_getwche_nolock

Requirements

Routine	Required header
_getche_nolock	<conio.h>
_getwche_nolock	<conio.h> or <wchar.h>

For more compatibility information, see Compatibility.

Example

// crt_getche_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 = _getche_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: abcdefyY

See also

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