puts, _putws

將字串 stdout 寫入 。

語法

int puts(
   const char *str
);
int _putws(
   const wchar_t *str
);

參數

str
輸出字串。

傳回值

如果成功，則傳回非負值。 如果 puts 失敗，則會傳 EOF 回 ;如果 _putws 失敗，則會傳 WEOF 回 。 如果 str 為 Null 指標，則會叫用不正確參數處理常式，如參數驗證 中所述 。 如果允許繼續執行，函式會設定 errno 為 EINVAL 並傳回 EOF 或 WEOF 。

如需這些錯誤碼和其他錯誤碼的相關資訊，請參閱 errno 、 _doserrno_sys_errlist 和 _sys_nerr 。

備註

函 puts 式會 str 寫入標準輸出資料流程 stdout ，將字串的終止 Null 字元 （'\0'） 取代為輸出資料流程中的分行符號 （'\n'）。

_putws 是 puts 的寬字元版本；如果資料流是以 ANSI 模式開啟，則這兩個函式的行為相同。 puts 目前不支援輸出至 UNICODE 資料流。

_putwch 使用目前的 CONSOLE LOCALE 設定來寫入 Unicode 字元。

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

泛型文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_putts	puts	puts	_putws

需求

常式	必要的標頭
puts	<stdio.h>
_putws	<stdio.h>

通用 Windows 平臺 （UWP） 應用程式中不支援主控台。 與主控台、 stdin 、 stdout 和 stderr 相關聯的標準資料流程控制碼必須先重新導向，C 執行時間函式才能在 UWP 應用程式中使用這些控制碼。 如需相容性詳細資訊，請參閱相容性。

程式庫

所有版本的 C 執行階段程式庫。

範例

// crt_puts.c
// This program uses puts to write a string to stdout.

#include <stdio.h>

int main( void )
{
   puts( "Hello world from puts!" );
}

輸出

Hello world from puts!

另請參閱

資料流 I/O
fputs, fputws
fgets, fgetws