puts、_putws

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

stdout に文字列を書き込みます。

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

パラメータ

str
出力する文字列。

戻り値

正常に終了した場合は、負でない値を返します。失敗した場合、puts 関数は EOF、_putws 関数は WEOF を返します。str が null ポインタの場合は、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、これらの関数は errno を EINVAL に設定し、EOF または WEOF を返します。

エラーコードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

puts 関数は、標準出力ストリーム (stdout) に、str に指定された文字列を書き込みます。このとき、文字列の終端の NULL 文字 (\0) を出力ストリームの改行文字 (\n) に置き換えます。

_putws は puts のワイド文字バージョンであり、ストリームが ANSI モードで開いている場合、この 2 つの関数の動作は同じです。現在の puts では、UNICODE ストリームへの出力はサポートされていません。

Windows 2000 以降では、_putwch 関数は、現在のコンソールのロケール設定に従って Unicode 文字を書き込みます。

汎用テキストルーチンのマップ

TCHAR.H のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_putts	puts	puts	_putws

必要条件

ルーチン	必須ヘッダー
puts	<stdio.h>
_putws	<stdio.h>

互換性の詳細については、「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!" );
}