puts、_putws
標準出力に文字列を記述します。
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
パラメーター
- str
文字列を出力します。
戻り値
成功した場合は、負の値を返します。puts が失敗した場合、を返します EOF; _putws が失敗した場合、WEOFを返します。str が null ポインターの場合は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。実行の継続が許可 EINVAL への関数によって設定された errno と戻り値の EOF または WEOF。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
puts 関数は出力ストリームの改行文字 ( "\n" ) と文字列の終端の null 文字 ( "" ) \0 を置き換える標準出力 str を stdoutストリームに書き込みます。
_putws は putsのワイド文字バージョンです; 2 個の関数は、ストリームが ANSI モードで開いている場合、動作は同じです。puts では、UNICODE ストリームへの出力はサポートされていません。
Windows 2000 の下および後で、はコンソールの現在のロケール設定を使用する _putwch の書き込みの Unicode 文字。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_putts |
puts |
puts |
_putws |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
コンソールは Windows ストア の apps ではサポートされていません。コンソール、stdin、stdout、および stderrに関連付けられている標準ストリームのハンドルは C のランタイム関数が Windows ストア の apps で使用する前にをリダイレクトする必要があります。互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
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!