putchar, putwchar

將一個字元寫入 stdout。

語法

int putchar(
   int c
);
wint_t putwchar(
   wchar_t c
);

參數

c
待寫入字元。

傳回值

傳回寫入的字元。 表示錯誤或檔案尾條件， 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。

具有 _nolock 尾碼的版本完全一致，不同之處在於不受保護，不能免於其他執行緒的干擾。 因為它們不會造成鎖定其他執行緒的額外負荷，所以可能會比較快。 這些函式只能用在安全執行緒內容 (例如單一執行緒應用程式) 或呼叫範圍已經處理執行緒隔離的地方。

根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

一般文字常式對應

需求

通用 Windows 平台 (UWP) 應用程式中不支援主控台。 與主控台 stdin、stdout 和 stderr 相關聯的標準資料流控制代碼必須重新導向，之後 C 執行階段函式才能在 UWP 應用程式中使用它們。 如需相容性詳細資訊，請參閱相容性。

程式庫

所有版本的 C 執行階段程式庫。

範例

// crt_putchar.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;

   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
      ch = putchar( *p );
}

輸出

This is the line of output

另請參閱

資料流 I/O
fputc, fputwc
getc, getwc