fputs fputws

發行項
03/26/2013

寫入至資料流。

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

參數

str
輸出字串。
stream
指向 FILE 結構的指標。

傳回值

如果成功，這些函式都會傳回非負值。在錯誤， fputs 傳回 EOF和 fputws 會傳回 WEOF。如果 str 或 stream 為 null 指標，這些函式叫用無效的參數處理常式，如參數驗證中所述。如果執行允許繼續，對 EINVAL 的這些函式設定的 errno 並傳回 EOF 或 WEOF。

如需更多關於這些和其他回傳碼的資訊，請參閱 _doserrno 、 errno 、 _sys_errlist 和 _sys_nerr (_doserrno, errno, _sys_errlist, and _sys_nerr) 。

備註

這些函式中的每個 str 複製到輸出 stream 目前所在位置。 fputws 分別複製寬字元引數 str 對 stream 做為多位元組字元字串或寬字元字串，根據可能的選取 stream 文字模式或二進位模式開啟。沒有函式複製結束的 null 字元。

資料流，則在 ANSI 模式中，開啟兩個函式的作用完全相同。 fputs 目前不支援輸出入 UNICODE 資料流。

泛用文字常式對應

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

需求

Function	必要的標頭檔
fputs	<stdio.h>
fputws	<stdio.h> 或 <wchar.h>

主控台 Windows 市集應用程式不支援。標準資料流控制代碼與主控台， stdin， stdout和 stderr，在這種情況下， C 執行階段函式在 Windows 市集應用程式之前，可以使用它們必須重新導向。如需其他相容性資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

// 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 );
}