_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Artículo
04/10/2013

Los formatos e imprime en la consola.Versiones más seguras están disponibles; vea _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Importante
Esta API no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /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] …
);

Parámetros

format
Cadena de la Formato-CONTROL.
argument
Parámetros opcionales.
locale
La configuración regional a utilizar.

Valor devuelto

El número de caracteres impreso.

Comentarios

Estas funciones de formato e imprime una serie de caracteres y valores directamente en la consola, mediante la función de _putch (_putwch para _cwprintf) para producir caracteres.Cada argument (si existe) se convierte y salida según la especificación correspondiente de formato en format.El formato tiene el mismo formato y función que el parámetro de format para la función de printf.A diferencia de fprintf, de printf, y las funciones de sprintf, ni _cprintf ni _cwprintf traduce los caracteres de avance de línea a combinaciones de fuentes de la retorno- línea de carro (CR-LF) cuando se genera.

Una diferencia importante es que _cwprintf muestra caracteres Unicode cuando se utiliza en Windows NT.A diferencia de _cprintf, _cwprintf utiliza la configuración regional actual de la consola.

Las versiones de estas funciones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en lugar de la configuración regional actual.

_cprintf valida el parámetro de format.Si format es un puntero NULL, la función invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, la función devuelve -1 y establece errno a EINVAL.

Nota sobre la seguridad
Asegúrese de que format no es una cadena definida por el usuario.

Asignaciones de la rutina de Genérico- texto

Rutina de Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

Requisitos

Rutina	Encabezado necesario
_cprintf,_cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

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