fputc fputwc
寫入資料流中的字元。
int fputc(
int c,
FILE *stream
);
wint_t fputwc(
wchar_t c,
FILE *stream
);
參數
c
要寫入的字元。stream
指向 FILE 結構的指標。
傳回值
這些函式都會傳回寫入的字元。對於 fputc，傳回值為 EOF 表示錯誤。對於 fputwc，傳回值為 WEOF 表示錯誤。如果 stream 是 NULL，這些函式叫用無效的參數處理常式，如 參數驗證中所述。如果執行允許繼續執行，則會傳回 EOF 並將 errno 設為 EINVAL。
如需更多關於這些和其他回傳碼的資訊，請參閱 _doserrno 、 errno 、 _sys_errlist 和 _sys_nerr (_doserrno, errno, _sys_errlist, and _sys_nerr) 。
備註
這些函式都會寫入單一字元 c 到檔案在關聯的檔案位置、位置指示器 (如果已定義) 和之前所指出的位置指示器屬性。在 fputc 和 fputwc的情況下，檔案相關聯的 stream*。*如果檔案在附加模式不支援定位要求也未開啟，字元附加至資料流的末端。
資料流，則在 ANSI 模式中，開啟兩個函式的作用完全相同。fputc 目前不支援輸出入 UNICODE 資料流。
與 _nolock 結尾的版本相同，但不會防止由其他執行緒的功能。如需詳細資訊，請參閱_fputc_nolock _fputwc_nolock。
常式特定圖例後面。
程序 |
備註 |
|---|---|
fputc |
相當於 putc，不過，只有會實作為函式，而不是函式和巨集。 |
fputwc |
fputc寬字元版本。為多位元組字元或寬字元寫入 c ，根據可能的選取 stream 文字模式或二進位模式下開啟。 |
泛用文字常式對應
TCHAR.H 常式 |
未定義 _UNICODE & _MBCS |
已定義 _MBCS |
已定義 _UNICODE |
|---|---|---|---|
_fputtc |
fputc |
fputc |
fputwc |
需求
Function |
必要的標頭檔 |
|---|---|
fputc |
<stdio.h> |
fputwc |
<stdio.h> 或 <wchar.h> |
主控台 Windows 市集 應用程式不支援。標準資料流控制代碼與主控台， stdin， stdout和 stderr，在這種情況下， C 執行階段函式在 Windows 市集 應用程式之前，可以使用它們必須重新導向。如需其他相容性資訊，請參閱入門介紹中的 相容性 (Compatibility) 。
範例
// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr1[] = "This is a test of fputc!!\n";
char *p;
// Print line to stream using fputc.
p = strptr1;
while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;
}