将字符写入 stdout。
语法
int _fputchar(
int c
);
wint_t _fputwchar(
wchar_t c
);
参数
c
要写入的字符。
返回值
其中每个函数都会返回写入的字符。 对于 _fputchar,返回值 EOF 指示一个错误。 对于 _fputwchar,返回值 WEOF 指示一个错误。 如果 c 为 NULL,这些函数会生成无效的参数异常,如参数验证中所述。 如果允许继续执行,则 _fputchar 返回 EOF(_fputwchar 会返回 WEOF),并且将 errno 设置为 EINVAL。
有关这些和其他错误代码的详细信息,请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。
备注
这两个函数都将单个字符参数 c 写入 stdout,并根据情况推进指示器。 _fputchar 等效于 fputc( stdout )。 它也等效于 putchar,但仅作为函数实现,而不是同时作为函数和宏实现。 与 fputc 和 putchar 不同,这些函数都不符合 ANSI 标准。
默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态。
一般文本例程映射
| Tchar.h 例程 | _UNICODE 和 _MBCS 未定义 |
_MBCS 已定义 |
_UNICODE 已定义 |
|---|---|---|---|
_fputtchar |
_fputchar |
_fputchar |
_fputwchar |
要求
| 函数 | 必需的标头 |
|---|---|
_fputchar |
<stdio.h> |
_fputwchar |
<stdio.h> 或 <wchar.h> |
通用 Windows 平台 (UWP) 应用中不支持控制台。 与控制台关联的标准流句柄(stdin、stdout 和 stderr)必须重定向,然后 C 运行时函数才能在 UWP 应用中使用它们。 有关兼容性的详细信息,请参阅 兼容性。
示例
// crt_fputchar.c
// This program uses _fputchar
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr[] = "This is a test of _fputchar!!\n";
char *p = NULL;
// Print line to stream using _fputchar.
p = strptr;
while( (*p != '\0') && _fputchar( *(p++) ) != EOF )
;
}
This is a test of _fputchar!!
另请参阅
流 I/O
%>
%>