putchar，putwchar

将字符写入 stdout。

语法

int putchar(
   int c
);
wint_t putwchar(
   wchar_t c
);

参数

c
要写入的字符。

返回值

返回写入的字符。 若要指示错误或文件结尾条件，putc 和 putchar 返回 EOF；putwc 和 putwchar 返回 WEOF。 对于所有四种例程，使用 ferror 或 feof 检查是否存在错误或文件结尾。 如果为 stream 传递了空指针，则这些函数会生成一个无效的参数异常，如“参数验证”中所述。 如果允许继续执行，这些函数则返回 EOF 或 WEOF，并将 errno 设置为 EINVAL。

有关返回代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

备注

putc 例程会在当前位置将单个字符 c 写入输出 stream。 任何整数都可以传递给 putc，但是只写入低 8 位。 putchar 例程等同于 putc( c, stdout )。 对于每个例程，如果发生读取错误，则会设置流的错误指示器。 putc 和 putchar 分别与 fputc 和 _fputchar 类似，但是都作为函数和宏实现（请参阅在函数和宏之间选择的建议）。 putwc 和 putwchar 分别是 putc 和 putchar 的宽字符版本。

带 _nolock 后缀的版本相同，但可能受到其他线程的影响。 它们可能更快，因为不会产生锁定其他线程的开销。 仅在线程安全的上下文中使用这些函数，如单线程应用程序或调用范围已经处理线程隔离。

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

一般文本例程映射

TCHAR.H 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_puttchar	putchar	putchar	putwchar

要求

例程	必需的标头
putchar	<stdio.h>
putwchar	<stdio.h> 或 <wchar.h>

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

库

C 运行时库的所有版本。

示例

// crt_putchar.c
/* This program uses putc to write buffer
* to a stream. If an error occurs, the program
* stops before writing the entire buffer.
*/

#include <stdio.h>

int main( void )
{
   FILE *stream;
   char *p, buffer[] = "This is the line of output\n";
   int  ch;

   ch = 0;

   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
      ch = putchar( *p );
}

输出

This is the line of output

另请参阅

流 I/O
fputc、fputwc
getc、getwc