在不锁定的情况下将字符推送回流中。
语法
int _ungetc_nolock(
int c,
FILE *stream
);
wint_t _ungetwc_nolock(
wint_t c,
FILE *stream
);
参数
c
要推送的字符。
stream
指向 FILE 结构的指针。
返回值
如果成功,则其中每个函数都会返回字符自变量 c。 如果无法推送回 c 或未读取任何字符,则输入流不改变且 _ungetc_nolock 返回 EOF;_ungetwc_nolock 返回 WEOF。 如果 stream 为 NULL,则将返回 EOF 或 WEOF,并且 errno 将设置为 EINVAL。
有关这些错误代码和其他错误代码的信息,请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。
备注
这些函数是 ungetc 和 ungetwc 的非锁定版本。 带 _nolock 后缀的版本相同,但可能受到其他线程的影响。 它们可能更快,因为不会产生锁定其他线程的开销。 仅在线程安全的上下文中使用这些函数,如单线程应用程序或调用范围已经处理线程隔离。
默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态。
一般文本例程映射
| TCHAR.H 例程 | _UNICODE 和 _MBCS 未定义 |
_MBCS 已定义 |
_UNICODE 已定义 |
|---|---|---|---|
_ungettc_nolock |
_ungetc_nolock |
_ungetc_nolock |
_ungetwc_nolock |
要求
| 例程 | 必需的标头 |
|---|---|
_ungetc_nolock |
<stdio.h> |
_ungetwc_nolock |
<stdio.h> 或 <wchar.h> |
有关兼容性的详细信息,请参阅 兼容性。
另请参阅
流 I/O
%>
%>