共用方式為


puts, _putws

將字串 stdout寫入 。

語法

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

參數

str
輸出字串。

傳回值

如果成功,則傳回非負值。 如果 puts 失敗,則會傳回 EOF;如果 _putws 失敗,則會傳回 WEOF。 如果 str 為 null 指標,則會叫用無效的參數處理常式,如參數驗證中所述。 如果允許繼續執行,函式會設定 errnoEINVAL 並傳回 EOFWEOF

如需這些錯誤碼及其他錯誤碼的相關資訊,請參閱:errno_doserrno_sys_errlist 以及 _sys_nerr

備註

puts 式會 str 寫入標準輸出數據流 stdout,將字串的終止 Null 字元 ('\0') 取代為輸出數據流中的換行符 ('\n')。

_putwsputs 的寬字元版本;如果資料流是以 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) 應用程式中不支援主控台。 與主控台 stdinstdoutstderr 相關聯的標準資料流控制代碼必須重新導向,之後 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