次の方法で共有


puts、_putws

更新 : 2007 年 11 月

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

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

パラメータ

  • str
    出力する文字列。

戻り値

正常に終了した場合は、負でない値を返します。失敗した場合、puts 関数は EOF_putws 関数は WEOF を返します。str が null ポインタの場合は、「パラメータの検証」に説明されているように、無効なパラメータ ハンドラが呼び出されます。実行の継続が許可された場合、これらの関数は errnoEINVAL に設定し、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!" );
}

出力

Hello world from puts!

.NET Framework の相当するアイテム

System::Console::Write

参照

参照

ストリーム入出力

fputs、fputws

fgets、fgetws