將字串 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!