_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Artículo
03/15/2013

Los formatos e imprime en la consola, con compatibilidad para los parámetros posicionales en la cadena de formato.

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_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 la Formato-CONTROL.
argument
Parámetros opcionales.
locale
La configuración regional a utilizar.

Valor devuelto

El número de caracteres formulario o un valor negativo si se produce un error.

Comentarios

Estas funciones formato e imprime una serie de caracteres y valores directamente en la consola, mediante _putch y _putwch funcionan 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_p.La diferencia entre _cprintf_p y cprintf_s es que _cprintf_p admite parámetros posicionales, que permite la especificación del orden en el que los argumentos se utilizan en la cadena de formato.Para obtener más información, vea parámetros posicionales De printf_p.

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

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

Además, como _cprintf_s y _cwprintf_s, validan el puntero de la entrada y la cadena de formato.Si format o argument es NULL, o de la cadena de formato contiene caracteres de formato no válidos, estas funciones se 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, estas funciones devuelven -1 y errno establecido en EINVAL.

Asignaciones de la rutina de Genérico- texto

Rutina de 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 en la Introducción.

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