_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Artículo
06/09/2015

Da formato e imprime en la consola, y admite parámetros posicionales en la cadena de formato.

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_p( 
   const char * format [, 
   argument] ... 
);
int _cprintf_p_l( 
   const char * format,
   locale_t locale [, 
   argument] ... 
);
int _cwprintf_p(
   const wchar * format [, 
   argument] ...
);
int _cwprintf_p_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 impreso o un valor negativo si se produce un error.

Comentarios

Estas funciones dan formato a una serie de caracteres y valores directamente en la consola, y la imprimen, mediante las funciones _putch y _putwch para producir 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_p. La diferencia entre _cprintf_p y cprintf_s es que _cprintf_p admite parámetros posicionales, lo que permite especificar el orden en el que se usan los argumentos en la cadena de formato. Para obtener más información, vea printf_p (Parámetros de posición).

A diferencia de las funciones fprintf_p, printf_p y sprintf_p, ni _cprintf_p ni _cwprintf_p 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_p muestra caracteres Unicode cuando se usa en Windows NT. A diferencia de _cprintf_p, _cwprintf_p 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.

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

Además, al igual que _cprintf_s y _cwprintf_s, validan el puntero de entrada y la cadena de formato. Si format o argument es NULL, o la cadena de formato contiene caracteres de formato no válidos, estas funciones invocan el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones devuelven -1 y establecen errno en EINVAL.

Asignaciones de rutina de texto genérico

Rutina Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcprintf_p	_cprintf_p	_cprintf_p	_cwprintf_p
_tcprintf_p_l	_cprintf_p_l	_cprintf_p_l	_cwprintf_p_l

Requisitos

Rutina	Encabezado necesario
_cprintf_p,_cprintf_p_l	<conio.h>
_cwprintf_p,_cwprintf_p_l	<conio.h>

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

Ejemplo

// crt_cprintf_p.c
// This program displays some variables to the console
// using the _cprintf_p function.

#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_p( "%2$d  %1$.4x  %3$u  %4$c %5$s\r\n", 
                h, i, u, c, s );
}