_cputs, _cputws

コンソールに文字列を書き込みます。

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

int _cputs(
   const char *str
);
int _cputws(
   const wchar_t *str
);

パラメーター

str
出力する文字列。

戻り値

正常に終了した場合、_cputs は 0 を返します。 関数が失敗した場合は 0 以外の値を返します。

解説

_cputs 関数は、str によって指される null で終わる文字列をコンソールに直接書き込みます。 復帰改行 (CR-LF) の組み合わせは、文字列に自動的に追加されません。

この関数は、そのパラメーターを検証します。 str が NULL の場合は、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行を続行できる場合、 errno は EINVAL に設定され、-1 が返されます。

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

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

Tchar.h のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_cputts	_cputs	_cputs	_cputws

要件

ルーチンによって返される値	必須ヘッダー	オプション ヘッダー
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

C ランタイム ライブラリのすべてのバージョン。

例

// crt_cputs.c
// compile with: /c
// This program first displays a string to the console.

#include <conio.h>
#include <errno.h>

void print_to_console(char* buffer)
{
   int retval;
   retval = _cputs( buffer );
   if (retval)
   {
       if (errno == EINVAL)
       {
         _cputs( "Invalid buffer in print_to_console.\r\n");
       }
       else
         _cputs( "Unexpected error in print_to_console.\r\n");
   }
}

void wprint_to_console(wchar_t* wbuffer)
{
   int retval;
   retval = _cputws( wbuffer );
   if (retval)
   {
       if (errno == EINVAL)
       {
         _cputws( L"Invalid buffer in wprint_to_console.\r\n");
       }
       else
         _cputws( L"Unexpected error in wprint_to_console.\r\n");
   }
}

int main()
{
   // String to print at console.
   // Notice the \r (return) character.
   char* buffer = "Hello world (courtesy of _cputs)!\r\n";
   wchar_t *wbuffer = L"Hello world (courtesy of _cputws)!\r\n";
   print_to_console(buffer);
   wprint_to_console( wbuffer );
}

Hello world (courtesy of _cputs)!
Hello world (courtesy of _cputws)!

関連項目

コンソール入出力とポート入出力
_putch, _putwch