fputs, fputws

將字串寫入資料流。

語法

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

參數

str
輸出字串。

stream
FILE 結構的指標。

傳回值

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

如需錯誤碼的詳細資訊，請參閱errno、 _doserrno_sys_errlist和 _sys_nerr。

備註

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

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

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

一般文字常式對應

需求

通用 Windows 平台 (UWP) 應用程式中不支援主控台。 與控制台stdin、、 stdout和 stderr相關聯的標準數據流句柄必須先重新導向，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