_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Da formato e imprime en la consola. Hay versiones más seguras disponibles; vea _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas en aplicaciones de la Plataforma universal de Windows.

Sintaxis

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]
);

Parámetros

format
Cadena de control de formato.

argument_list
Parámetros opcionales para la cadena de formato.

locale
Configuración regional que se va a usar.

Valor devuelto

Número de caracteres que se van a imprimir.

Comentarios

Estas funciones dan formato a una serie de caracteres y valores directamente en la consola, usando la función _putch (_putwch en el caso de _cwprintf) para generar los caracteres. Cada argumento de argument_list (si existe) se convierte y se genera según la especificación de formato correspondiente de format. El format argumento usa la sintaxis de especificación de formato para las funciones printf y wprintf. A diferencia de las fprintffunciones _cprintf , printfy sprintf , y _cwprintf no traducen caracteres de avance de línea en combinaciones de avance de línea de retorno de carro (CR-LF) cuando se genera la salida.

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

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

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

Importante

Asegúrese de que format no es una cadena definida por el usuario.

A partir de Windows 10 versión 2004 (compilación 19041), la familia de funciones printf imprime números de punto flotante que se pueden representar con exactitud según las reglas de redondeo de IEEE 754. En versiones anteriores de Windows, los números de punto flotante que se pueden representar de forma exacta y terminan en "5" siempre se redondean al alza. IEEE 754 indica que deben redondearse al dígito par más próximo (también conocido como "redondeo bancario"). Por ejemplo, tanto printf("%1.0f", 1.5) como printf("%1.0f", 2.5) deben redondearse a 2. Anteriormente, 1,5 se redondearía a 2 y 2,5 a 3. Este cambio solo afecta a los números que se pueden representar de forma exacta. Por ejemplo, 2,35 (que, cuando se representa en memoria, está más cerca de 2,35000000000000008) se sigue redondeando hasta 2,4. El redondeo realizado por estas funciones ahora también respeta el modo de redondeo de punto flotante que fesetround establece. Anteriormente, el redondeo siempre elegía el comportamiento FE_TONEAREST. Este cambio solo afecta a los programas compilados con Visual Studio 2019 versión 16.2 y posteriores. Para usar el comportamiento de redondeo de punto flotante heredado, establezca un vínculo con legacy_stdio_float_rounding.obj.

Asignaciones de rutinas de texto genérico

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

Requisitos

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

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

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

-16  001d  62511  A Test

Consulte también

E/S de consola y puerto
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l
Sintaxis de especificación de formato: printf y wprintf funciones