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

Запись форматированных данных в строку с возможностью указать порядок использования параметров в строке формата.Write formatted data to a string with the ability to specify the order that the parameters are used in the format string.

СинтаксисSyntax

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]
);

ПараметрыParameters

двойнойbuffer
Место хранения выходных данныхStorage location for output

сизеофбуфферsizeOfBuffer
Наибольшее число символов для хранения.Maximum number of characters to store.

formatformat
Строка управления форматом.Format-control string.

argument_listargument_list
Необязательные аргументы для строки формата.Optional arguments to the format string.

localelocale
Используемый языковой стандарт.The locale to use.

Дополнительные сведения см. в разделе Спецификации формата.For more information, see Format Specifications.

Возвращаемое значениеReturn Value

Число записанных символов или-1, если произошла ошибка.The number of characters written, or -1 if an error occurred.

КомментарииRemarks

Функция _sprintf_p форматирует и сохраняет последовательность символов и значений в буфере.The _sprintf_p function formats and stores a series of characters and values in buffer. Каждый аргумент в argument_list (при его наличии) преобразуется и выводится в соответствии с соответствующей спецификацией формата в формате.Each argument in the argument_list (if any) is converted and output according to the corresponding format specification in format. Аргумент Format использует синтаксис спецификации формата для функций printf и wprintf.The format argument uses the format specification syntax for printf and wprintf functions. После последнего написанного символа добавляется символ null.A null character is appended after the last character written. Если копирование производится между перекрывающимися строками, поведение не определено.If copying occurs between strings that overlap, the behavior is undefined. Различие между _sprintf_p и sprintf_s заключается в том, что _sprintf_p поддерживает позиционированные параметры, позволяющие указать порядок, в котором аргументы используются в строке формата.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. Дополнительные сведения см. в разделе Позиционные параметры printf_p.For more information, see printf_p Positional Parameters.

_swprintf_p — это версия _sprintf_p для расширенных символов; аргументы-указатели для _swprintf_p являются строками расширенных символов._swprintf_p is a wide-character version of _sprintf_p; the pointer arguments to _swprintf_p are wide-character strings. Обнаружение ошибок кодирования в _swprintf_p может отличаться от _sprintf_p.Detection of encoding errors in _swprintf_p may differ from that in _sprintf_p. _swprintf_p и fwprintf_p работают одинаково, за исключением того, что _swprintf_p записывает выходные данные в строку, а не в назначение файла типа, а _swprintf_p требует, чтобы параметр Count указал максимальное число символов для записи._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. Версии этих функций с суффиксом _l идентичны за исключением того, что они используют переданный параметр языкового стандарта вместо локали текущего потока.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 возвращает число байтов, хранящихся в буфере, без подсчета завершающего нуль символа._sprintf_p returns the number of bytes stored in buffer, not counting the terminating null character. _swprintf_p возвращает количество расширенных символов, хранящихся в буфере, без учета завершающего расширенного символа null._swprintf_p returns the number of wide characters stored in buffer, not counting the terminating null wide character. Если buffer или Format является пустым указателем или строка формата содержит недопустимые символы форматирования, вызывается обработчик недопустимых параметров, как описано в разделе Проверка параметров.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. Если выполнение может быть продолжено, эти функции возвращают-1 и устанавливают для еинвал значение.If execution is allowed to continue, these functions return -1 and set errno to EINVAL.

Универсальное текстовое сопоставление функцийGeneric-Text Routine Mappings

Подпрограмма TCHAR.HTCHAR.H routine _UNICODE и _MBCS не определены_UNICODE & _MBCS not defined _MBCS определено_MBCS defined _UNICODE определено_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

ТребованияRequirements

ПодпрограммаRoutine Обязательный заголовокRequired 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> или <wchar.h><stdio.h> or <wchar.h>

Дополнительные сведения о совместимости см. в статье Compatibility.For additional compatibility information, see Compatibility.

Пример. Использование _sprintf_p для форматирования данныхExample: 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

Пример: обработка кода ошибкиExample: 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

См. также разделSee also

Потоковый ввод-выводStream 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
Функции vprintfvprintf Functions
printf_p позиционированные параметрыprintf_p Positional Parameters