puts, _putws

  • [アーティクル]

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

構文

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

パラメーター

str
出力する文字列。

戻り値

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

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

解説

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

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

_putwch は、現在の CONSOLE LOCALE 設定を使用して Unicode 文字を書き込みます。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

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

TCHAR.H のルーチン _UNICODE と _MBCS が定義されていない _MBCS が定義されている _UNICODE が定義されている
_putts puts puts _putws

必要条件

ルーチンによって返される値 必須ヘッダー
puts <stdio.h>
_putws <stdio.h>

ユニバーサル Windows プラットフォーム (UWP) アプリではコンソールがサポートされていません。 コンソール (stdin、stdout、stderr) に関連付けられている標準ストリームのハンドルは、C ランタイム関数によって UWP アプリで使用される前に、リダイレクトする必要があります。 互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

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!

関連項目

ストリーム入出力
fputs, fputws
fgets, fgetws