fputc、fputwc

将字符写入流。

int fputc(
   int c,
   FILE *stream 
);
wint_t fputwc(
   wchar_t c,
   FILE *stream 
);

参数

  • c
    要写入的字符。

  • stream
    指向 FILE 结构的指针。

返回值

这些函数都返回一个写好的字符。 为 fputc,EOF 的返回值指示错误。 为 fputwc,WEOF 的返回值指示错误。 如果 stream 为 NULL, 则函数调用无效参数处理程序, 如 参数验证所述. 如果允许执行继续,则这些函数返回 EOF 并将 errno 设置为 EINVAL。

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

备注

这些功能在关联的文件位置指示器(如果定义)编写单个字符 c 并根据需要事先指示。 在 fputc 和 fputwc中, 文件与 stream*.*关联如果文件不支持位置请求或以附加方式打开,字符追加到流的末尾。

如果流在 ANSI 模式中打开,这两个函数具有相同的行为。 fputc 当前不支持输出到 UNICODE 流。

与 _nolock 后缀的版本与相同,但它们不由其他线程的干扰保护。 有关详细信息,请参阅_fputc_nolock、_fputwc_nolock.

实例特定的备注。

例程

备注

fputc

与 putc等效,但是仅实现为函数,而不是函数和宏。

fputwc

fputc的宽字符版本。 编写 c 作为多字节字符或宽字符,根据 stream 是以文本模式还是二进制模式打开。

一般文本例程映射

TCHAR.H 例程

未定义 _UNICODE & _MBCS

已定义 _MBCS

已定义 _UNICODE

_fputtc

fputc

fputc

fputwc

要求

功能

必需的标头

fputc

<stdio.h>

fputwc

<stdio.h> 或 <wchar.h>

控制台在 Windows 应用商店 应用程序中不受支持。 与控制台 stdin、stdout 和 stderr 关联的标准流句柄必须重定向,然后 C 运行时函数才可以在 Windows 应用商店 应用程序中使用它们。 有关兼容性的更多信息,请参见兼容性

示例

// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
 

#include <stdio.h>

int main( void )
{
   char strptr1[] = "This is a test of fputc!!\n";
   char *p;

   // Print line to stream using fputc. 
   p = strptr1;
   while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;

}
  

.NET Framework 等效项

请参见

参考

流 I/O

fgetc、fgetwc

putc、putwc