putc, putwc
將一個字元寫入資料流。
語法
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
參數
c
待寫入字元。
stream
FILE 結構的指標。
傳回值
傳回寫入的字元。 表示錯誤或檔案尾條件， putc 並 putchar 傳回 EOF; putwc 並 putwchar 傳回 WEOF。 針對這四個例程，請使用 ferror 或 feof 來檢查錯誤或檔尾。 如果 傳遞的 streamNull 指標，則會叫用無效的參數處理程式，如參數驗證中所述。 如果允許繼續執行，這些函式會傳回 EOF 或 WEOF，並將 設定 errno 為 EINVAL。
如需傳回碼的詳細資訊，請參閱errno、 _doserrno_sys_errlist和 _sys_nerr。
備註
putc 常式會將單一字元 c 寫入至目前位置的輸出 stream。 任何整數都可以傳遞至 putc，但只會寫入較低的 8 位元。 例 putchar 程與 putc( c, stdout )相同。 針對每個常式，如果發生讀取錯誤，則會設定資料流的錯誤指標。 putc 和 putchar 分別與 fputc 和 _fputchar類似，但會同時實作為函式和宏（請參閱 在函式和宏之間選擇的建議）。 putwc 和 putwchar 分別是寬字元版本的 putc 和 putchar。 如果資料流在 ANSI 模式中開啟，則 putwc 和 putc 的行為相同。 putc 目前不支援輸出至 UNICODE 資料流。
具有 _nolock 尾碼的版本完全一致，不同之處在於不受保護，不能免於其他執行緒的干擾。 如需詳細資訊，請參閱 _putc_nolock、_putwc_nolock。
根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。
一般文字常式對應
| TCHAR.H 常式 | _UNICODE 和 _MBCS 未定義 |
_MBCS 已定義 |
_UNICODE 已定義 |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
需求
| 常式 | 必要的標頭 |
|---|---|
putc |
<stdio.h> |
putwc |
<stdio.h> 或 <wchar.h> |
通用 Windows 平台 (UWP) 應用程式中不支援主控台。 與主控台 stdin、stdout 和 stderr 相關聯的標準資料流控制代碼必須重新導向，之後 C 執行階段函式才能在 UWP 應用程式中使用它們。 如需相容性詳細資訊，請參閱相容性。
程式庫
所有版本的 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 );
}
輸出
This is the line of output