Compartir a través de


_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Da formato e imprime en la consola. Existen versiones más seguras; 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 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 control de formato.

  • argument
    Parámetros opcionales.

  • 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, y la imprimen, mediante la función _putch (_putwch para _cwprintf) para generar caracteres. Cada argument (si existe) se convierte y sale según la especificación de formato correspondiente de format. El formato tiene las mismas forma y función que el parámetro de format de la función printf. A diferencia de las funciones fprintf, printf y sprintf, ni _cprintf ni _cwprintf convierten los caracteres de salto de línea en combinaciones retorno de carro-salto de línea (CR-LF) en sus resultados.

Una diferencia importante es que _cwprintf muestra caracteres Unicode cuando se usa en Windows NT. 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.

Nota de seguridadNota sobre la seguridad

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

Asignaciones de rutina 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

Rutina

Encabezado necesario

_cprintf,_cprintf_l

<conio.h>

_cwprintf, _cwprintf_l

<conio.h>

Para obtener más información sobre compatibilidad, vea 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 );
}
  

Equivalente en .NET Framework

No es aplicable Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

Vea también

Referencia

E/S de consola y de 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: Funciones printf y wprintf