_ungetch, , _ungetwch_ungetch_nolock_ungetwch_nolock

Помещает обратно последний символ, считанный из консоли.

Синтаксис

int _ungetch(
   int c
);
wint_t _ungetwch(
   wint_t c
);
int _ungetch_nolock(
   int c
);
wint_t _ungetwch_nolock(
   wint_t c
);

Параметры

c
Символ, который требуется поместить обратно.

Возвращаемое значение

Обе функции возвращают символ c в случае успешного выполнения. Если возникла ошибка, _ungetch возвращает значение EOF и _ungetwch возвращается WEOF.

Замечания

Эти функции возвращают символ c обратно в консоль, что приводит c к следующему символу, считываемого _getch или (или _getche )._getwch _getwche _ungetch и _ungetwch завершится ошибкой, если они вызываются более одного раза до следующего чтения. Аргумент c может не иметь значение EOF (или WEOF).

Версии с суффиксом _nolock идентичны, за исключением того, что они не защищены от вмешательства другими потоками. Они могут быть быстрее, так как они не влечет за собой затраты на блокировку других потоков. Используйте эти функции только в потокобезопасных контекстах, например в однопоточных приложениях или если вызываемая область уже обрабатывает изоляцию потоков.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Требования

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

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

См. также

Консоль и порт ввода-вывода
_cscanf, , _cscanf_l_cwscanf_cwscanf_l
_getch, _getwch