_vcprintf、 _vcprintf_l、 _vcwprintf、 _vcwprintf_l

引数リストへのポインターを使用して、書式付き出力をコンソールに書き込みます。 これらの関数のより安全なバージョンを使用できます。 _vcprintf_s、 _vcprintf_s_l、 _vcwprintf_s、 _vcwprintf_s_lを参照してください。

構文

int _vcprintf(
   const char* format,
   va_list argptr
);
int _vcprintf_l(
   const char* format,
   _locale_t locale,
   va_list argptr
);
int _vcwprintf(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_l(
   const wchar_t* format,
   _locale_t locale,
   va_list argptr
);

パラメーター

format
書式の指定。

argptr
引数リストへのポインター。

locale
使用するロケール。

詳細については、「書式指定構文」を参照してください。

戻り値

書き込まれた文字数。出力エラーが発生した場合は負の値を返します。 format が null ポインターである場合は、「パラメーターの検証」で説明されているとおり、無効なパラメーター ハンドラーが呼び出されます。 実行を続行できる場合、 errno は EINVAL に設定され、-1 が返されます。

解説

これらの各関数は、引数リストへのポインターを使用して、指定されたデータを書式化してコンソールに書き込みます。 _vcwprintf 関数は、_vcprintf 関数のワイド文字バージョンです。 引数としてワイド文字列を使用します。

_l サフィックスが付いているこれらの関数の各バージョンは、現在のロケールの代わりに渡されたロケール パラメーターを使用する点を除いて同じです。

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

要件

* UNIX V の互換性のために必要です。

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

例

// crt_vcprintf.cpp
// compile with: /c
#include <conio.h>
#include <stdarg.h>

// An error formatting function used to print to the console.
int eprintf(const char* format, ...)
{
    va_list args;
    va_start(args, format);
    int result = _vcprintf(format, args);
    va_end(args);
    return result;
}

int main()
{
    eprintf("(%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
           "<some error text>");
    eprintf("    (Related to symbol '%s' defined on line %d).\n",
            "<symbol>", 5 );
}

(10,23): Error C2111 : <some error text>
    (Related to symbol '<symbol>' defined on line 5).

関連項目

ストリーム入出力
vprintf 関数
_cprintf、 _cprintf_l、 _cwprintf、 _cwprintf_l
fprintf、 _fprintf_l、 fwprintf、 _fwprintf_l
printf、 _printf_l、 wprintf、 _wprintf_l
sprintf、 _sprintf_l、 swprintf、 _swprintf_l、 __swprintf_l
va_arg、 va_copy、 va_end、 va_start