_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Статья
04/10/2013

Форматирует и выводятся на консоль.Более безопасные версии доступны; в разделе _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Важно
Этот API нельзя использовать в приложениях, запускаемых в среде выполнения Windows.Дополнительные сведения см. в разделе Функции CRT не поддерживаются при /ZW.

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

Параметры

format
Строка Формат-элемента управления.
argument
Необязательные параметры.
locale
Используемый языковой стандарт.

Возвращаемое значение

Вывод числа символов.

Заметки

Эти функции формате и типу последовательность символов и значения непосредственно на консоль, с помощью функции _putch (_putwch ) для _cwprintf для вывода символы.Каждый объект argument (если есть), а результат преобразуется в соответствии с соответствующим спецификации формата в format.Формат имеет те же форму и функцию, что и параметр format для функции printf.В отличие от классов fprintf, printf и sprintf, ни _cprintf, ни _cwprintf переводят символы перевода чтроки сочетания канала в очереди возврата экипажа () CR-LF выходных данных.

Важное отличие заключается в том, что _cwprintf указывает символы юникода при использовании в Windows NT.В отличие от _cprintf, _cwprintf использует текущие параметры языкового стандарта консоли.

Версии этих функций с суффиксом _l идентичны за исключением того, что они используют параметры языкового стандарта, в вместо текущего языкового стандарта.

_cprintf проверяет параметр format.Если format указатель, функция вызывает обработчик недопустимого параметра, как описано в разделе Проверка параметров.Если продолжение выполнения разрешено, функция возвращает -1 и устанавливает errno в значение EINVAL.

Примечание по безопасности
Убедитесь, что format не является строкой, определяемой пользователем.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	Не указаны _UNICODE и _MBCS	определенные _MBCS	Определение _UNICODE
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

Требования

Функция	Требуемый заголовок
_cprintf,_cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Пример

// 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 );
}