_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Da formato e imprime en la consola. Estas versiones de _cprintf, _cprintf_l, _cwprintf, _cwprintf_l tienen mejoras de seguridad, como se describe en características de seguridad de CRT.

System_CAPS_ICON_important.jpg Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para más información, vea Funciones de CRT no admitidas con /ZW.

int _cprintf_s(   
   const char * format [,   
   argument] ...   
);  
int _cprintf_s_l(   
   const char * format,  
   locale_t locale [,   
   argument] ...   
);  
int _cwprintf_s(  
   const wchar * format [,   
   argument] ...  
);  
int _cwprintf_s_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.

Número de caracteres que se van a imprimir.

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_s) para generar los caracteres. Cada argument (si existe) se convierte y sale según la especificación de formato correspondiente de format. El formato tiene el mismo formato y función que el format parámetro para la printf_s (función). A diferencia de las funciones fprintf_s, printf_s y sprintf_s, ni _cprintf_s ni _cwprintf_s 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_s muestra caracteres Unicode cuando se usa en Windows NT. A diferencia de _cprintf_s, _cwprintf_s 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.

System_CAPS_ICON_important.jpg Importante

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

Al igual que las versiones no seguras (vea _cprintf, _cprintf_l, _cwprintf, _cwprintf_l), estas funciones validan sus parámetros e invocan el controlador de parámetros no válidos, como se describe en validación de parámetrossi format es un puntero nulo. Estas funciones se diferencian de las versiones no seguras en que también se valida la propia cadena de formato. Si hay algún especificador de formato desconocido o con formato incorrecto, estas funciones invocan el controlador de parámetros no válidos. En todos los casos, si la ejecución puede continuar, las 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_s_cprintf_s_cprintf_s_cwprintf_s
_tcprintf_s_l_cprintf_s_l_cprintf_s_l_cwprintf_s_l
RutinaEncabezado necesario
_cprintf_s,_cprintf_s_l<conio.h>
_cwprintf_s, _cwprintf_s_l<conio.h>

Para obtener más información sobre compatibilidad, vea Compatibility.

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

// crt_cprintf_s.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_s( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );  
}  

-16  001d  62511  A Test  

E/S de consola y puerto
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l
printf_s, _printf_s_l, wprintf_s, _wprintf_s_l
sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l
vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l
Sintaxis de especificación de formato: funciones de printf y wprintf

Mostrar: