_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Devuelve el número de caracteres de la cadena con formato, con la capacidad de especificar el orden en el que los parámetros se utilizan 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 la Formato-CONTROL.

• argument
  argumentos opcionales.

• locale
  la configuración regional a utilizar.

Valor devuelto

Devuelve el número de caracteres que se generará si se imprimiera o se enviara la cadena a un archivo o un búfer mediante los códigos de formato especificados.El valor devuelto no incluye el carácter null de terminación._scwprintf_p realiza la misma función por caracteres anchos.

La diferencia entre _scprintf_py _scprintfes que _scprintf_padmite 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.

Si format es un puntero de NULL , 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.

Para obtener información sobre éstos y otros códigos de error, vea _doserrno, errno, _sys_errlist, y _sys_nerr.

Comentarios

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

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

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

Asignaciones de la rutina de texto genérico

rutina de Tchar.h	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_sctprintf_p	_scprintf_p	_scprintf_p	_scwprintf_p
_sctprintf_p_l	_scprintf_p_l	_scprintf_p_l	_scwprintf_p_l

Requisitos

rutina	Encabezado necesario
_scprintf_p, _scprintf_p_l	<stdio.h>
_scwprintf_p, _scwprintf_p_l	<stdio.h> o <wchar.h>

Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.

Vea también

Referencia

E/S de la secuencia

_scprintf, _scprintf_l, _scwprintf, _scwprintf_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l