Compartir a través de


_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l

Escriba los datos con formato en una cadena con la capacidad de especificar el orden en que los parámetros se utilizan en la cadena de formato.

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

Parámetros

  • buffer
    Ubicación de almacenamiento para los resultados

  • sizeOfBuffer
    Número máximo de caracteres que se pueden almacenar.

  • format
    Cadena de control de formato

  • argument
    Argumentos opcionales

  • locale
    Configuración regional que se va a usar.

Para obtener más información, vea Especificaciones de formato.

Valor devuelto

El número de caracteres escrito, o – 1 si se ha producido un error.

Comentarios

La función de _sprintf_p da formato y almacena una serie de caracteres y valores en buffer. Cada argument (si existe) se convierte y sale según la especificación de formato correspondiente de format. El formato consta de los caracteres ordinarios y tiene el mismo formato y función que el argumento de format para printf_p. Un carácter de NULL se anexan después del último carácter con tipo. Si la copia tiene lugar entre cadenas que se superponen, el comportamiento es indefinido. 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. Para obtener más información, vea printf_p (Parámetros de posición).

_swprintf_p es una versión con caracteres anchos de _sprintf_p; los argumentos de puntero a _swprintf_p son cadenas de carácter ancho. La detección de errores de codificación en _swprintf_p puede diferir de la de _sprintf_p. _swprintf_p y fwprintf_p se comportan exactamente igual excepto que _swprintf_p escribe la salida en una cadena y no en un destino de tipo FILE y _swprintf_p requiere el parámetro count para especificar el número máximo de caracteres que se escriban. 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.

_sprintf_p devuelve el número de bytes almacenados en buffer, sin contar el carácter de NULL que finaliza. _swprintf_pdevuelve el número de caracteres anchos almacenados en buffer, sin contar el carácter ancho de NULL que finaliza. Si buffer o format es un puntero NULL, o si la cadena de formato contiene caracteres de formato no válidos, 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 establecen errno en EINVAL.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_stprintf_p

_sprintf_p

_sprintf_p

_swprintf_p

_stprintf_p_l

_sprintf_p_l

_sprintf_p_l

_swprintf_p_l

Requisitos

Rutina

Encabezado necesario

_sprintf_p, _sprintf_p_l

<stdio.h>

_swprintf_p, _swprintf_p_l

<stdio.h> o <wchar.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

// 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 );
}
  
// 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 );
}
  

Equivalente en .NET Framework

System::String::Format

Vea también

Referencia

E/S de secuencia

_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

fprintf, _fprintf_l, fwprintf, _fwprintf_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

printf, _printf_l, wprintf, _wprintf_l

scanf, _scanf_l, wscanf, _wscanf_l

sscanf, _sscanf_l, swscanf, _swscanf_l

sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l

vprintf (Funciones)

printf_p (Parámetros de posición)