_cprintf、_cprintf_l、_cwprintf、_cwprintf_l_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

書式化してコンソールに出力します。Formats and prints to the console. セキュリティが強化されたバージョンがあります。「_cprintf_s、_cprintf_s_l、_cwprintf_s、_cwprintf_s_l」をご覧ください。More-secure versions are available; see _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。This API cannot be used in applications that execute in the Windows Runtime. 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。For more information, see CRT functions not supported in Universal Windows Platform apps.

構文Syntax

int _cprintf(
   const char * format [, argument_list]
);
int _cprintf_l(
   const char * format,
   locale_t locale [, argument_list]
);
int _cwprintf(
   const wchar * format [, argument_list]
);
int _cwprintf_l(
   const wchar * format,
   locale_t locale [, argument_list]
);

パラメーターParameters

formatformat
書式指定文字列。Format-control string.

argument_listargument_list
書式指定文字列の省略可能なパラメーター。Optional parameters for the format string.

localelocale
使用するロケール。The locale to use.

戻り値Return Value

出力された文字数。The number of characters printed.

RemarksRemarks

これらの関数の書式を設定し、一連の文字や、コンソールへの直接値を使用して、 _putch関数 (_putwch_cwprintf) 文字を出力する.These functions format and print a series of characters and values directly to the console, using the _putch function (_putwch for _cwprintf) to output characters. 各引数argument_list (ある場合) は変換されに対応する書式指定に応じて形式します。Each argument in argument_list (if any) is converted and output according to the corresponding format specification in format. 形式引数は、書式指定構文の printf および wprintf 関数します。The format argument uses the format specification syntax for printf and wprintf functions. 異なり、 fprintfprintf、およびsprintf関数も、 _cprintf_cwprintfライン フィード文字をキャリッジ リターンとライン フィード (CR-LF) の組み合わせに変換するときに出力します。Unlike the fprintf, printf, and sprintf functions, neither _cprintf nor _cwprintf translates line-feed characters into carriage return-line feed (CR-LF) combinations when output.

重要な違いは _cwprintf Windows で使用すると、Unicode 文字が表示されます。An important distinction is that _cwprintf displays Unicode characters when used in Windows. 異なり _cprintf_cwprintfコンソールの現在のロケール設定を使用します。Unlike _cprintf, _cwprintf uses the current console locale settings.

これらの関数のバージョン、 _l現在のロケールの代わりに渡されたロケール パラメーターを使用する点を除いて、サフィックスは同じです。The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current locale.

_cprintf検証、形式パラメーター。_cprintf validates the format parameter. 場合形式null ポインターの場合で説明されているように、関数が、無効なパラメーター ハンドラーを呼び出しますパラメーターの検証です。If format is a null pointer, the function invokes the invalid parameter handler, as described in Parameter Validation. 実行の継続、関数の戻り値-1 とセットが許可された場合errnoEINVALします。If execution is allowed to continue, the function returns -1 and sets errno to EINVAL.

重要

format にユーザー定義の文字列を指定しないでください。Ensure that format is not a user-defined string.

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

Tchar.h のルーチンTchar.h routine _UNICODE および _MBCS が未定義の場合_UNICODE and _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
_tcprintf_tcprintf _cprintf_cprintf _cprintf_cprintf _cwprintf_cwprintf
_tcprintf_l_tcprintf_l _cprintf_l_cprintf_l _cprintf_l_cprintf_l _cwprintf_l_cwprintf_l

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
_cprintf_cprintf_l_cprintf, _cprintf_l <conio.h><conio.h>
_cwprintf_cwprintf_l_cwprintf, _cwprintf_l <conio.h><conio.h>

互換性の詳細については、「 互換性」を参照してください。For more compatibility information, see Compatibility.

Example

// crt_cprintf.c
// compile with: /c
// This program displays some variables to the console.

#include <conio.h>

int main( void )
{
    int         i = -16,
                h = 29;
    unsigned    u = 62511;
    char        c = 'A';
    char        s[] = "Test";

    // Note that console output does not translate \n as
    // standard output does. Use \r\n instead.
    //
    _cprintf( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}
-16  001d  62511  A Test

関連項目See also

コンソール入出力とポート入出力Console and Port I/O
_cscanf、_cscanf_l、_cwscanf、_cwscanf_l_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
fprintf、_fprintf_l、fwprintf、_fwprintf_lfprintf, _fprintf_l, fwprintf, _fwprintf_l
printf、_printf_l、wprintf、_wprintf_lprintf, _printf_l, wprintf, _wprintf_l
sprintf、_sprintf_l、swprintf、_swprintf_l、__swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
vfprintf、_vfprintf_l、vfwprintf、_vfwprintf_lvfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l
_cprintf_s、_cprintf_s_l、_cwprintf_s、_cwprintf_s_l_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
_cprintf_p、_cprintf_p_l、_cwprintf_p、_cwprintf_p_l_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l
書式指定構文: printf 関数と wprintf 関数Format Specification Syntax: printf and wprintf Functions