_cprintf_p, _cprintf_p_l, , _cwprintf_p, _cwprintf_p_l

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

Sintaxis

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 el mismo formulario y función que el format parámetro de la printf_p función. 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, consulte printf_p (Parámetros de posición).

A diferencia de las fprintf_pfunciones _cprintf_p , printf_py sprintf_p , y _cwprintf_p 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 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.

Además, al igual que _cprintf_s y _cwprintf_s, validan el puntero de entrada y la cadena de formato. Si format o argument son NULL, o de la cadena de formato contiene caracteres de formato no válidos, estas funciones invocan al 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 rutinas de texto genérico

Requisitos

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

-16  001d  62511  A Test

Vea también

E/S de consola y de puerto
_cscanf, _cscanf_l, , _cwscanf, _cwscanf_l
_cscanf_s, _cscanf_s_l, , _cwscanf_s, _cwscanf_s_l
_fprintf_p, _fprintf_p_l, , _fwprintf_p, _fwprintf_p_l
fprintf_s, _fprintf_s_l, , fwprintf_s, _fwprintf_s_l
_printf_p, _printf_p_l, , _wprintf_p, _wprintf_p_l
printf_s, _printf_s_l, , wprintf_s, _wprintf_s_l
_sprintf_p, _sprintf_p_l, , _swprintf_p, _swprintf_p_l
_vfprintf_p, _vfprintf_p_l, , _vfwprintf_p, _vfwprintf_p_l
_cprintf_s, _cprintf_s_l, , _cwprintf_s, _cwprintf_s_l
printf_p (parámetros de posición)
Sintaxis de especificación de formato: printf y wprintf funciones