%>

将字符写入 stdout

语法

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

参数

c
要写入的字符。

返回值

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

有关返回代码的详细信息,请参阅 errno_doserrno_sys_errlist_sys_nerr

注解

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

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

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

一般文本例程映射

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

要求

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

通用 Windows 平台 (UWP) 应用中不支持控制台。 与控制台、stdinstdoutstderr 关联的标准流句柄必须重定向,然后 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
%>
%>