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