puts、_putws
寫一個字串到 stdout。
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
參數
- str
輸出字串。
傳回值
如果成功,傳回非負數的值。 如果 puts 失敗,則會傳回 EOF;如果 _putws 失敗,則會傳回 WEOF。 如果 str 如 參數驗證 中所述為 null 指標,則叫用無效參數處理常式。 如果允許繼續執行,函式會將 errno 設為 EINVAL,並傳回 EOF or WEOF。
如需有關這些錯誤碼和其他錯誤碼的詳細資訊,請參閱 _doserrno、errno、_sys_errlist 和 _sys_nerr。
備註
對應至標準輸出資料流 stdout的 puts 函式寫入 str ,取代在輸出資料流的字串結束 null 字元 (「\ 0 」) 與換行字元 (「\ n」) 。
_putws 是 puts的寬字元版本;如果資料流在 ANSI 模式中開啟,則兩個函式的作用完全相同。 puts 目前不支援輸出到 UNICODE 串流。
在 Windows 2000 和以後的版本, _putwch 寫入使用目前主控台地區設定的 Unicode 字元。
一般文字常式對應
TCHAR.H 常式 |
未定義 _UNICODE & _MBCS |
已定義 _MBCS |
已定義 _UNICODE |
---|---|---|---|
_putts |
puts |
puts |
_putws |
需求
常式 |
必要的標頭 |
---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
Windows 市集 應用程式不支援主控台。 與主控台關聯的標準資料流控制代碼 (stdin、stdout 和 stderr) 必須重新導向,然後 C 執行階段函式才能在 Windows 市集 應用程式中使用它們。 如需其他相容性資訊,請參閱相容性。
程式庫
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!" );
}
Output
Hello world from puts!