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

Zapisz sformatowane dane w ciągu z możliwością określenia kolejności, w których parametry są używane w ciągu formatu.Write formatted data to a string with the ability to specify the order that the parameters are used in the format string.

SkładniaSyntax

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

ParametryParameters

buffer
Lokalizacja magazynu dla danych wyjściowychStorage location for output

sizeOfBuffer
Maksymalna liczba znaków do zapisania.Maximum number of characters to store.

format
Ciąg kontroli formatu.Format-control string.

argument_list
Opcjonalne argumenty ciągu formatu.Optional arguments to the format string.

locale
Ustawienia regionalne do użycia.The locale to use.

Aby uzyskać więcej informacji, zobacz Specyfikacja formatu.For more information, see Format Specifications.

Wartość zwracanaReturn Value

Liczba napisanych znaków lub -1 w przypadku wystąpienia błędu.The number of characters written, or -1 if an error occurred.

UwagiRemarks

Funkcja _sprintf_p formatuje i przechowuje serię znaków i wartości w pliku buffer .The _sprintf_p function formats and stores a series of characters and values in buffer. Każdy argument w pliku (jeśli istnieje) jest konwertowany i wyprowadzany argument_list zgodnie z odpowiadającą specyfikacją formatu w . formatEach argument in the argument_list (if any) is converted and output according to the corresponding format specification in format. Argument formatu używa składni specyfikacji formatu dla funkcji printf wprintf i.The format argument uses the format specification syntax for printf and wprintf functions. Znak null jest dołączany po ostatnim zapisanym znaku.A null character is appended after the last character written. Jeśli kopiowanie odbywa się między nakładającymi się ciągami, zachowanie jest niezdefiniowane.If copying occurs between strings that overlap, the behavior is undefined. Różnica między i polega na tym, że obsługuje parametry _sprintf_p sprintf_s pozycyjne, co umożliwia określenie kolejności, w której argumenty są _sprintf_p używane w ciągu formatu.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. Aby uzyskać więcej informacji, zobacz printf_p Parametry pozyacyjne.For more information, see printf_p Positional Parameters.

_swprintf_p jest wersją znaku szerokiego _sprintf_p ; argumenty wskaźnika do są _swprintf_p ciągami znaków szerokokątnych._swprintf_p is a wide-character version of _sprintf_p; the pointer arguments to _swprintf_p are wide-character strings. Wykrywanie błędów kodowania w _swprintf_p programie może się różnić od wykrywania w pliku _sprintf_p .Detection of encoding errors in _swprintf_p may differ from that in _sprintf_p. _swprintf_p Parametry i zachowują się identycznie z tą różnicą, że zapisuje dane wyjściowe w ciągu, a nie w miejscu docelowym typu , i wymaga parametru w celu określenia maksymalnej liczby znaków do fwprintf_p _swprintf_p FILE _swprintf_p count zapisu._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. Wersje tych funkcji z sufiksem są identyczne z tą różnicą, że używają one parametru ustawień regionalnych przekazanego zamiast _l bieżących ustawień regionalnych wątku.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 Zwraca liczbę bajtów przechowywanych w buffer , nie licząc kończącego się znaku null._sprintf_p returns the number of bytes stored in buffer, not counting the terminating null character. _swprintf_p Zwraca liczbę znaków szerokich przechowywanych w , bez zliczania buffer kończącego się znakiem szerokim o wartości null._swprintf_p returns the number of wide characters stored in buffer, not counting the terminating null wide character. Jeśli parametr lub jest wskaźnikiem o wartości null lub jeśli ciąg formatu zawiera nieprawidłowe znaki formatowania, wywoływana jest procedura obsługi nieprawidłowych parametrów, zgodnie z opisem w buffer format temacie Walidacja parametru.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. Jeśli wykonanie może kontynuować, te funkcje zwracają wartość -1 i errno ustawiają wartość EINVAL .If execution is allowed to continue, these functions return -1 and set errno to EINVAL.

Ważne

Począwszy od Windows 10 wersji 2004 (kompilacja 19041), rodzina funkcji drukuje dokładnie reprezentacje liczb zmiennoprzecinków zgodnie z regułami printf IEEE 754 na temat zaokrąglania.Starting in Windows 10 version 2004 (build 19041), the printf family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. W poprzednich wersjach systemu Windows liczba zmiennoprzecinkowa, która kończyła się cyfrą "5", zawsze była zaokrąglana w górę.In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 stwierdza, że muszą one zaokrąglić do najbliższej cyfry even (znanej również jako "Zaokrąglanie bankierze").IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). Na przykład oba i printf("%1.0f", 1.5) powinny printf("%1.0f", 2.5) zaokrąglić do 2.For example, both printf("%1.0f", 1.5) and printf("%1.0f", 2.5) should round to 2. Wcześniej 1,5 zaokrąglało do 2, a 2,5 do 3.Previously, 1.5 would round to 2 and 2.5 would round to 3. Ta zmiana dotyczy tylko dokładnie reprezentacji liczb.This change only affects exactly representable numbers. Na przykład 2,35 (co, gdy jest reprezentowane w pamięci, jest bliższe 2,35000000000008) będzie nadal zaokrąglać w górę do 2,4.For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Zaokrąglanie wykonywane przez te funkcje teraz również respektuje tryb zaokrąglania zmiennoprzecinkowego ustawiony fesetround przez .Rounding done by these functions now also respects the floating point rounding mode set by fesetround. Wcześniej zaokrąglanie zawsze wybierało FE_TONEAREST zachowanie.Previously, rounding always chose FE_TONEAREST behavior. Ta zmiana dotyczy tylko programów budowaną przy użyciu Visual Studio 2019 w wersji 16.2 i nowszych.This change only affects programs built using Visual Studio 2019 version 16.2 and later. Aby użyć starszego zachowania zaokrąglania zmiennoprzecinkowego, połącz za pomocą funkcji "legacy_stdio_float_rounding.obj".To use the legacy floating point rounding behavior, link with 'legacy_stdio_float_rounding.obj`.

Mapowania procedur zwykłego tekstuGeneric-Text Routine Mappings

TCHAR.H RutynowychTCHAR.H routine _UNICODE & _MBCS nie zdefiniowano_UNICODE & _MBCS not defined _MBCS Zdefiniowane_MBCS defined _UNICODE Zdefiniowane_UNICODE defined
_stprintf_p _sprintf_p _sprintf_p _swprintf_p
_stprintf_p_l _sprintf_p_l _sprintf_p_l _swprintf_p_l

WymaganiaRequirements

ProceduraRoutine Wymagany nagłówekRequired 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> lub <wchar.h><stdio.h> or <wchar.h>

Aby uzyskać dodatkowe informacje o zgodności, zobacz Zgodność.For additional compatibility information, see Compatibility.

Przykład: używanie _sprintf_p do formatowania danychExample: 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

Przykład: Obsługa kodu błęduExample: 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

Zobacz teżSee also

We/Wy strumieniaStream 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
vprintf Funkcjevprintf Functions
printf_p Parametry pozyacyjneprintf_p Positional Parameters