分享方式:


fputs, fputws

將字串寫入資料流。

語法

int fputs(
   const char *str,
   FILE *stream
);
int fputws(
   const wchar_t *str,
   FILE *stream
);

參數

str
輸出字串。

stream
FILE 結構的指標。

傳回值

如果函式成功,則每個函式都會傳回非負值。 發生錯誤時,fputsfputws 會傳回 EOF。 如果 strstream 為 Null 指標,這些函式會叫用無效的參數處理程式,如參數驗證中所述。 如果允許繼續執行,這些函式會設定 errnoEINVAL ,然後傳回 EOF

如需錯誤碼的詳細資訊,請參閱errno_doserrno_sys_errlist_sys_nerr

備註

所有這些函式都會將 str 複製至輸出 stream 的目前位置。 fputws當以文字模式或二進位模式開啟時stream,將寬字元自變數strstream複製到 做為多位元組字元字串或寬字元字串。 任一函式都不會複製終止 Null 字元。

如果資料流是以 ANSI 模式開啟,則這兩個函式的行為相同。 fputs 目前不支援輸出至 UNICODE 資料流。

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

一般文字常式對應

TCHAR.H 常式 _UNICODE_MBCS 未定義 _MBCS 已定義 _UNICODE 已定義
_fputts fputs fputs fputws

需求

函式 必要的標頭
fputs <stdio.h>
fputws <stdio.h> 或 <wchar.h>

通用 Windows 平台 (UWP) 應用程式中不支援主控台。 與控制台stdin、、 stdoutstderr相關聯的標準數據流句柄必須先重新導向,C 運行時間函式才能在 UWP app 中使用它們。 如需相容性詳細資訊,請參閱相容性

範例

// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.

#include <stdio.h>

int main( void )
{
   fputs( "Hello world from fputs.\n", stdout );
}
Hello world from fputs.

另請參閱

資料流 I/O
fgets, fgetws
gets, _getws
puts, _putws