通过

putc， putwc

  • 项目

写入流的字符。

int putc(
   int c,
   FILE *stream 
);
wint_t putwc(
   wchar_t c,
   FILE *stream 
);

参数

  • c
    要写入的字符。

  • stream
    为 文件 结构的指针。

返回值

返回编写的字符。若要指示错误或文件结尾条件，putc 和 putchar 返回 EOF; putwc 和 putwchar 返回 WEOF。对于所有四个实例，请使用 ferror 或 feof 检查错误或文件结尾。如果通过 stream的 NULL 指针，无效参数调用处理程序，如 参数验证所述。如果执行允许继续，这些函数返回 EOF 或 WEOF 并将 errno 到 EINVAL。

请参见 _doserrno、errno、_sys_errlist 和_sys_nerr 有关这些内容的更多信息以及其他情况下，错误代码。

备注

putc 实例写入输出 stream 的单个字符 c 在当前位置。任何整数可以传递给 putc，但是，仅较低的 8 位编写。putchar 实例。**putc(c,stdout )**相同。对于每个实例，因此，如果读取错误，流的错误指示器设置。putc 和 putchar 分别为类似于 fputc 和 _fputchar，但是，实现为函数和作为宏 (请参见 选择在函数和宏之间)。putwc 和 putwchar 分别为 putc 和 putchar的宽字符版本，即。如果流在 ANSI 模式下，中打开putwc 和 putc 具有相同的行为。putc 当前不支持输出到 UNICODE 流。

与 _nolock 后缀的版本与相同，但它们不从由其他线程的干扰保护。有关更多信息，请参见 _putc_nolock, _putwc_nolock。

一般文本例程映射

TCHAR.H 实例

未定义的_UNICODE & _MBCS

定义的_MBCS

定义的_UNICODE

_puttc

putc

putc

putwc

要求

实例

必需的标头

putc

<stdio.h>

putwc

<stdio.h> 或 <wchar.h>

控件个在 Windows 应用商店 apps 不受支持。标准流处理与控件个，stdin，stdout和 stderr，在 C 运行时函数在 Windows 应用商店 apps 之前，可以使用它们必须重定向。有关其他的兼容性信息，请参见中介绍的 兼容性。

库

C 运行库的所有版本。

示例

// crt_putc.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;
   /* Make standard out the stream and write to it. */
   stream = stdout;
   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
      ch = putc( *p, stream );
}

Output

This is the line of output

.NET Framework 等效项

请参见

参考

流I/O

fputc， fputwc

getc， getwc