fputs、fputws

發行項
06/09/2015

將字串寫入一個資料流。

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，並且fputs回傳EOF，和fputws傳回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 市集應用程式中使用它們。如需其他相容性資訊，請參閱相容性。

範例

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