_getche_nolock, _getwche_nolock

Artigo
06/09/2015

Obtém um caractere do console com eco e sem bloquear o segmento.

Importante

Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

int _getche_nolock( void );
wint_t _getwche_nolock( void );

Valor de retorno

Retorna a leitura de caracteres. Não há nenhum retorno de erro.

Comentários

_getche_nolock e _getwche_nolock são idênticos a _getche e _getwche exceto que não são protegidos contra a interferência de outros threads. Elas podem ser mais rápidas, pois não incorrem na sobrecarga de bloquear outros threads. Use essas funções somente em contextos de thread-safe, como aplicativos single-threaded ou onde o escopo de chamada já manipula o isolamento do thread.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_gettche_nolock	_getche_nolock	_getch_nolock	_getwche_nolock

Requisitos

Rotina	Cabeçalho necessário
_getche_nolock	<conio.h>
_getwche_nolock	<conio.h> ou <wchar.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// 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 
}