_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

 

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

Devuelve el número de caracteres en la cadena con formato, con la capacidad de especificar el orden en que se usan parámetros en la cadena de formato.

int _scprintf_p(  
   const char *format [,  
   argument] ...   
);  
int _scprintf_p_l(  
   const char *format,  
   locale_t locale [,  
   argument] ...   
);  
int _scwprintf_p (  
   const wchar_t *format [,  
   argument] ...   
);  
int _scwprintf_p _l(  
   const wchar_t *format,  
   locale_t locale [,  
   argument] ...   
);  

Parámetros

format
Cadena de control de formato.

argument
Argumentos opcionales.

locale
Configuración regional que se va a usar.

Devuelve el número de caracteres que se generará si la cadena se imprime o envía a un archivo o el búfer mediante los códigos de formato especificados. El valor devuelto no incluye el carácter nulo de terminación. _scwprintf_prealiza la misma función para caracteres anchos.

La diferencia entre _scprintf_p y _scprintf es que _scprintf_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 posicionales.

Si format es una NULL se invoca el puntero, el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, estas funciones devuelven -1 y establecen errno en EINVAL.

Para obtener información sobre estos y otros códigos de error, consulte _doserrno, errno, _sys_errlist y _sys_nerr.

Cada argument (si existe) se convierten según la especificación de formato correspondiente en format. El formato consta de caracteres ordinarios y tiene el mismo formato y función que el argumento format para printf.

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 del subproceso actual.

System_CAPS_ICON_important.jpg Importante

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
_sctprintf_p_scprintf_p_scprintf_p_scwprintf_p
_sctprintf_p_l_scprintf_p_l_scprintf_p_l_scwprintf_p_l
RutinaEncabezado necesario
_scprintf_p, _scprintf_p_l<stdio.h>
_scwprintf_p, _scwprintf_p_l<stdio.h> o <wchar.h>

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

E/S de secuencia
_scprintf, _scprintf_l, _scwprintf, _scwprintf_l
_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Mostrar: