putchar, putwchar

將一個字元寫入 stdout。

語法

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

參數

c
待寫入字元。

傳回值

傳回寫入的字元。 表示錯誤或檔案結尾條件， putc 並 putchar 傳回 EOF ; putwc 並 putwchar 傳回 WEOF 。 針對這四個常式，請使用 ferror 或 feof 來檢查錯誤或檔案結尾。 如果 傳遞 的 stream Null 指標，這些函式會產生不正確參數例外狀況，如參數驗證 中所述 。 如果允許繼續執行，則會傳回 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 中的全域狀態。

泛型文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_puttchar	putchar	putchar	putwchar

需求

常式	必要的標頭
putchar	<stdio.h>
putwchar	<stdio.h > 或 < wchar.h>

通用 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