ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: _ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock	_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock	4/2/2020	_ungetch_nolock _ungetwch_nolock _ungetwch _ungetch _o__ungetch _o__ungetch_nolock _o__ungetwch _o__ungetwch_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	CONIO/_ungetch CONIO/_ungetch_nolock CORECRT_WCONIO/_ungetwch CORECRT_WCONIO/_ungetwch_nolock TCHAR/_ungettch TCHAR/_ungettch_nolock _ungetch _ungetch_nolock _ungetwch _ungetwch_nolock _ungettch _ungettch_nolock	_ungetch function ungetwch function characters, pushing back to console _ungettch_nolock function ungettch function _ungettch function ungetch_nolock function ungettch_nolock function _ungetwch_nolock function _ungetch_nolock function ungetwch_nolock function _ungetwch function	70ae71c6-228c-4883-a57d-de6d5f873825

_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock

Pushes back the last character that's read from the console.

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 _ungetch(
   int c
);
wint_t _ungetwch(
   wint_t c
);
int _ungetch_nolock(
   int c
);
wint_t _ungetwch_nolock(
   wint_t c
);

Parameters

c
Character to be pushed.

Return value

Both functions return the character c if successful. If there's an error, _ungetch returns a value of EOF and _ungetwch returns WEOF.

Remarks

These functions push the character c back to the console, causing c to be the next character read by _getch or _getche (or _getwch or _getwche). _ungetch and _ungetwch fail if they're called more than once before the next read. The c argument may not be EOF (or WEOF).

The versions with the _nolock suffix are identical except that they aren't protected from interference by other threads. They may be faster since 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
_ungettch	_ungetch	_ungetch	_ungetwch
_ungettch_nolock	_ungetch_nolock	_ungetch_nolock	_ungetwch_nolock

Requirements

Routine	Required header
_ungetch, _ungetch_nolock	<conio.h>
_ungetwch, _ungetwch_nolock	<conio.h> or <wchar.h>

For more compatibility information, see Compatibility.

Example

// crt_ungetch.c
// compile with: /c
// In this program, a white-space delimited
// token is read from the keyboard. When the program
// encounters a delimiter, it uses _ungetch to replace
// the character in the keyboard buffer.
//

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

int main( void )
{
   char buffer[100];
   int count = 0;
   int ch;

   ch = _getche();
   while( isspace( ch ) )      // Skip preceding white space.
      ch = _getche();
   while( count < 99 )         // Gather token.
   {
      if( isspace( ch ) )      // End of token.
         break;
      buffer[count++] = (char)ch;
      ch = _getche();
   }
   _ungetch( ch );            // Put back delimiter.
   buffer[count] = '\0';      // Null terminate the token.
   printf( "\ntoken = %s\n", buffer );
}

Whitetoken = White

See also

Console and port I/O
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
_getch, _getwch