_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l

Escriba datos con formato en una cadena con la capacidad de especificar el orden en el que se usan los parámetros en la cadena de formato.Write formatted data to a string with the ability to specify the order that the parameters are used in the format string.

SintaxisSyntax

int _sprintf_p(
   char *buffer,
   size_t sizeOfBuffer,
   const char *format [,
   argument_list]
);
int _sprintf_p_l(
   char *buffer,
   size_t sizeOfBuffer,
   const char *format,
   locale_t locale [,
   argument_list]
);
int _swprintf_p(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format [,
   argument_list]
);
int _swprintf_p_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format,
   locale_t locale [,
   argument_list]
);

ParámetrosParameters

búferbuffer
Ubicación de almacenamiento para los resultadosStorage location for output

sizeOfBuffersizeOfBuffer
Número máximo de caracteres que se pueden almacenar.Maximum number of characters to store.

formatformat
Cadena de control de formato.Format-control string.

argument_listargument_list
Argumentos opcionales para la cadena de formato.Optional arguments to the format string.

localelocale
Configuración regional que se va a usar.The locale to use.

Para obtener más información, vea Especificaciones de formato.For more information, see Format Specifications.

Valor devueltoReturn Value

Número de caracteres escritos, o-1 si se ha producido un error.The number of characters written, or -1 if an error occurred.

ObservacionesRemarks

La función _sprintf_p da formato y almacena una serie de caracteres y valores en el búfer.The _sprintf_p function formats and stores a series of characters and values in buffer. Cada argumento del argument_list (si existe) se convierte y se genera de acuerdo con la especificación de formato correspondiente en el formato.Each argument in the argument_list (if any) is converted and output according to the corresponding format specification in format. El argumento Format usa la Sintaxis de especificación de formato para las funciones printf y wprintf.The format argument uses the format specification syntax for printf and wprintf functions. Un carácter null se anexa después del último carácter escrito.A null character is appended after the last character written. Si la copia tiene lugar entre cadenas que se superponen, el comportamiento es indefinido.If copying occurs between strings that overlap, the behavior is undefined. La diferencia entre _sprintf_p y sprintf_s es que _sprintf_p admite parámetros posicionales, lo que permite especificar el orden en el que se usan los argumentos en la cadena de formato.The difference between _sprintf_p and sprintf_s is that _sprintf_p supports positional parameters, which allows specifying the order in which the arguments are used in the format string. Para más información, vea printf_p (Parámetros de posición).For more information, see printf_p Positional Parameters.

_swprintf_p es una versión con caracteres anchos de _sprintf_p; los argumentos de puntero para _swprintf_p son cadenas de caracteres anchos._swprintf_p is a wide-character version of _sprintf_p; the pointer arguments to _swprintf_p are wide-character strings. La detección de errores de codificación en _swprintf_p puede diferir de la de _sprintf_p.Detection of encoding errors in _swprintf_p may differ from that in _sprintf_p. _swprintf_p y fwprintf_p se comportan exactamente igual, salvo que _swprintf_p escribe la salida en una cadena en lugar de en un destino de tipo File, y _swprintf_p requiere que el parámetro Count especifique el número máximo de caracteres que se van a escribir._swprintf_p and fwprintf_p behave identically except that _swprintf_p writes output to a string rather than to a destination of type FILE, and _swprintf_p requires the count parameter to specify the maximum number of characters to be written. Las versiones de estas funciones con el sufijo _L son idénticas, salvo que utilizan el parámetro de configuración regional que se pasa en lugar de la configuración regional del subproceso actual.The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current thread locale.

_sprintf_p devuelve el número de bytes almacenados en el búfer, sin contar el carácter null de terminación._sprintf_p returns the number of bytes stored in buffer, not counting the terminating null character. _swprintf_p devuelve el número de caracteres anchos almacenados en el búfer, sin contar el carácter ancho final null._swprintf_p returns the number of wide characters stored in buffer, not counting the terminating null wide character. Si buffer o Format es un puntero nulo, o si la cadena de formato contiene caracteres de formato no válidos, se invoca el controlador de parámetros no válidos, tal y como se describe en validación de parámetros.If buffer or format is a null pointer, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in Parameter Validation. Si la ejecución puede continuar, estas funciones devuelven-1 y establecen errno en EINVAL.If execution is allowed to continue, these functions return -1 and set errno to EINVAL.

Asignaciones de rutina de texto genéricoGeneric-Text Routine Mappings

Rutina TCHAR.HTCHAR.H routine _UNICODE y _MBCS no definidos_UNICODE & _MBCS not defined _MBCS definido_MBCS defined _UNICODE definido_UNICODE defined
_stprintf_p_stprintf_p _sprintf_p_sprintf_p _sprintf_p_sprintf_p _swprintf_p_swprintf_p
_stprintf_p_l_stprintf_p_l _sprintf_p_l_sprintf_p_l _sprintf_p_l_sprintf_p_l _swprintf_p_l_swprintf_p_l

RequisitosRequirements

RutinaRoutine Encabezado necesarioRequired header
_sprintf_p, _sprintf_p_l_sprintf_p, _sprintf_p_l <stdio.h>
_swprintf_p, _swprintf_p_l_swprintf_p, _swprintf_p_l <stdio.h> o <wchar.h><stdio.h> or <wchar.h>

Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

Ejemplo: usar _sprintf_p para dar formato a los datosExample: Use _sprintf_p to format data

// crt_sprintf_p.c
// This program uses _sprintf_p to format various
// data and place them in the string named buffer.
//

#include <stdio.h>

int main( void )
{
    char     buffer[200],
            s[] = "computer", c = 'l';
    int      i = 35,
            j;
    float    fp = 1.7320534f;

    // Format and print various data:
    j  = _sprintf_p( buffer, 200,
                     "   String:    %s\n", s );
    j += _sprintf_p( buffer + j, 200 - j,
                     "   Character: %c\n", c );
    j += _sprintf_p( buffer + j, 200 - j,
                     "   Integer:   %d\n", i );
    j += _sprintf_p( buffer + j, 200 - j,
                     "   Real:      %f\n", fp );

    printf( "Output:\n%s\ncharacter count = %d\n",
            buffer, j );
}
Output:
   String:    computer
   Character: l
   Integer:   35
   Real:      1.732053

character count = 79

Ejemplo: control de código de errorExample: Error code handling

// crt_swprintf_p.c
// This is the wide character example which
// also demonstrates _swprintf_p returning
// error code.
#include <stdio.h>

#define BUFFER_SIZE 100

int main( void )
{
    wchar_t buffer[BUFFER_SIZE];
    int     len;

    len = _swprintf_p(buffer, BUFFER_SIZE, L"%2$s %1$d",
                      0, L" marbles in your head.");
    _printf_p( "Wrote %d characters\n", len );

    // _swprintf_p fails because string contains WEOF (\xffff)
    len = _swprintf_p(buffer, BUFFER_SIZE, L"%s",
                      L"Hello\xffff world" );
    _printf_p( "Wrote %d characters\n", len );
}
Wrote 24 characters
Wrote -1 characters

Vea tambiénSee also

E/S de secuenciaStream I/O
_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l
fprintf, _fprintf_l, fwprintf, _fwprintf_lfprintf, _fprintf_l, fwprintf, _fwprintf_l
_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l
printf, _printf_l, wprintf, _wprintf_lprintf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
scanf, _scanf_l, wscanf, _wscanf_lscanf, _scanf_l, wscanf, _wscanf_l
sscanf, _sscanf_l, swscanf, _swscanf_lsscanf, _sscanf_l, swscanf, _swscanf_l
sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_lsscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l
Funciones de vprintf (vprintf Functions
printf_p parámetros posicionalesprintf_p Positional Parameters