_cputs、_cputws
コンソールに文字列を設定します。
重要 |
---|
この API は Windows ランタイムで実行されるアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
int _cputs( const char *str ); int _cputws( const wchar_t *str );
パラメーター
- str
文字列を出力します。
戻り値
、_cputs 成功した場合は 0 を返します。関数が失敗した場合、ゼロ以外の値を返します。
解説
_cputs 関数は、コンソールへの str によって直接指す null で終わる文字列を書き込みます。キャリッジ リターンとライン フィード (CR-LF) の組み合わせは、文字列に自動的に追加されません。
この関数は、パラメーターを検証します。str が **[NULL]**場合、無効なパラメーター ハンドラーが パラメーターの検証に説明されているように、開始されます。実行の継続が許可された場合、errno が EINVAL に設定され、関数から -1 が返されます。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_cputts |
_cputs |
_cputs |
_cputws |
必要条件
ルーチン |
必須ヘッダー |
オプション ヘッダー |
---|---|---|
_cputs |
<conio.h> |
<errno.h> |
_cputws |
<conio.h> |
<errno.h> |
互換性の詳細については、互換性を参照してください。
ライブラリ
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)!