puts、_putws
stdout に文字列を出力します。
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
パラメーター
- str
出力する文字列。
戻り値
正常に終了した場合は、0 以上の値を返します。 puts が失敗した場合、EOF を返します。_putws が失敗した場合、WEOF を返します。 str が null ポインターの場合は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、この関数は errno を EINVAL に設定し、EOF または WEOF を返します。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
puts 関数は、str を標準出力ストリーム stdout に書き込みます。出力ストリームで文字列の終端の null 文字 ('\0') は改行文字 ('\n') に置き換えられます。
_putws は puts のワイド文字バージョンであり、ストリームが ANSI モードで開いている場合、この 2 つの関数の動作は同じです。 puts では、UNICODE ストリームへの出力はサポートされていません。
Windows 2000 以降では、_putwch は現在の CONSOLE LOCALE 設定を使用して 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!" );
}
出力
Hello world from puts!