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
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應