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 ) ;
}