puts、_putwsputs, _putws

stdout に文字列を書き込みます。Writes a string to stdout.

構文Syntax

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

パラメーターParameters

strstr
出力する文字列。Output string.

戻り値Return Value

正常に終了した場合は、0 以上の値を返します。Returns a nonnegative value if successful. 場合配置失敗すると、それを返しますEOF場合 _putws失敗すると、それを返しますWEOFします。If puts fails, it returns EOF; if _putws fails, it returns WEOF. 場合str null ポインターの場合で説明されているとおり、無効なパラメーター ハンドラーが呼び出されますパラメーターの検証です。If str is a null pointer, the invalid parameter handler is invoked, as described in Parameter Validation. 実行の継続が許可された場合、関数が設定errnoEINVAL戻ってEOFまたはWEOFします。If execution is allowed to continue, the functions set errno to EINVAL and return EOF or WEOF.

エラー コードの詳細については、「_doserrno、errno、_sys_errlist、_sys_nerr」をご覧ください。For information on these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

RemarksRemarks

配置関数strを標準出力ストリームにstdout、置換文字列の終端の null 文字 ('\0') は改行文字 ('\n') で、出力ストリーム。The puts function writes str to the standard output stream stdout, replacing the string's terminating null character ('\0') with a newline character ('\n') in the output stream.

_putwsのワイド文字バージョンは、配置; 2 つの関数は、動作、ストリームが ANSI モードで開かれている場合は同じです。_putws is the wide-character version of puts; the two functions behave identically if the stream is opened in ANSI mode. 配置UNICODE ストリームへの出力をサポートされていません。puts doesn't currently support output into a UNICODE stream.

_putwchは現在の CONSOLE LOCALE 設定を使用して Unicode 文字を書き出します。_putwch writes Unicode characters using the current CONSOLE LOCALE setting.

汎用テキスト ルーチンのマップGeneric-Text Routine Mappings

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
_putts_putts putsputs putsputs _putws_putws

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
putsputs <stdio.h><stdio.h>
_putws_putws <stdio.h><stdio.h>

ユニバーサル Windows プラットフォーム (UWP) アプリでは、コンソールがサポートされていません。The console is not supported in Universal Windows Platform (UWP) apps. コンソールに関連付けられている標準ストリームのハンドルstdinstdout、およびstderr、C ランタイム関数が UWP アプリで使用する前にリダイレクトする必要があります.The standard stream handles that are associated with the console, stdin, stdout, and stderr, must be redirected before C run-time functions can use them in UWP apps. 互換性の詳細については、「 互換性」を参照してください。For additional compatibility information, see Compatibility.

ライブラリLibraries

C ランタイム ライブラリのすべてのバージョン。All versions of the C run-time libraries.

Example

// crt_puts.c
// This program uses puts to write a string to stdout.

#include <stdio.h>

int main( void )
{
   puts( "Hello world from puts!" );
}

出力Output

Hello world from puts!

関連項目See also

ストリーム入出力Stream I/O
fputs、fputwsfputs, fputws
fgets、fgetwsfgets, fgetws