ungetc，ungetwc

将字符重新推送到流上。

语法

int ungetc(
   int c,
   FILE *stream
);
wint_t ungetwc(
   wint_t c,
   FILE *stream
);

参数

c
要推送的字符。

stream
指向 FILE 结构的指针。

返回值

如果成功，则其中每个函数都会返回字符自变量 c。 如果无法推送回 c 或未读取任何字符，则输入流不改变且 ungetc 返回 EOF；ungetwc 返回 WEOF。 如果 stream 为 NULL，则会调用无效的参数处理程序，如参数验证中所述。 如果允许执行继续，则返回 EOF 或 WEOF并将 errno 设置为 EINVAL。

有关这些错误代码和其他错误代码的信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

注解

ungetc 函数将字符 c 重新推送到 stream 上，并清除文件结尾指示符。 流必须打开以供读取。 stream 上的后续读取操作以 c 开始。 将忽略尝试使用 ungetc 将 EOF 重新推送到流上。

如果从流中读取此字符前调用了 fflush、fseek、fsetpos、或 rewind，则可能会消除 ungetc 在流上放置的字符。 文件位置指示符将拥有将字符推送回之前的值。 对应流的外部存储未改变。 对文本流的 ungetc 调用成功后，将不指定文件位置指示符，直至读取或弃用推送回的所有字符。 每次对二进制流的 ungetc 调用成功后，文件位置指示符将减少；如果调用前其值为 0，则调用后不定义此值。

如果调用了 ungetc 两次且在两次调用之间没有读取或文件定位操作，则结果不可预知。 调用 fscanf 后，除非已执行其他读取操作（例如 getc），否则对 ungetc 的调用可能会失败，因为 fscanf 本身会调用 ungetc。

ungetwc 是 ungetc 的宽字符版本。 但是，每次对文本或二进制流的 ungetwc 调用成功后，将不指定文件位置指示符的值，直至读取或弃用推送回的所有字符。

这些函数线程安全并会在执行期间锁定敏感数据。 有关非锁定版本，请参阅 _ungetc_nolock、_ungetwc_nolock。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

TCHAR.H 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_ungettc	ungetc	ungetc	ungetwc

要求

例程	必需的标头
ungetc	<stdio.h>
ungetwc	<stdio.h> 或 <wchar.h>

通用 Windows 平台 (UWP) 应用中不支持控制台。 与控制台、stdin、stdout 和 stderr 关联的标准流句柄必须重定向，然后 C 运行时函数才能在 UWP 应用中使用它们。 有关兼容性的详细信息，请参阅 兼容性。

示例

// crt_ungetc.c
// This program first converts a character
// representation of an unsigned integer to an integer. If
// the program encounters a character that is not a digit,
// the program uses ungetc to replace it in the  stream.
//

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

int main( void )
{
   int ch;
   int result = 0;

   // Read in and convert number:
   while( ((ch = getchar()) != EOF) && isdigit( ch ) )
      result = result * 10 + ch - '0';    // Use digit.
   if( ch != EOF )
      ungetc( ch, stdin );                // Put nondigit back.
   printf( "Number = %d\nNext character in stream = '%c'",
            result, getchar() );
}

      521aNumber = 521
Next character in stream = 'a'

另请参阅

流 I/O
getc、getwc
putc、putwc