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 (_doserrno, errno, _sys_errlist, and _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 市集 應用程式不支援。 標準資料流控制代碼與主控台， stdin， stdout和 stderr，在這種情況下， C 執行階段函式在 Windows 市集 應用程式之前，可以使用它們必須重新導向。 如需其他相容性資訊，請參閱入門介紹中的 相容性 (Compatibility) 。
程式庫
所有的 C 執行階段程式庫 (C run-time libraries) 版本。
範例
// 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