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 中的全域狀態。

泛型文字常式對應

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

需求

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

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