sprintf, , _sprintf_l, swprintf, _swprintf, , _swprintf_l__swprintf_l

Zapisywanie sformatowanych danych w ciągu. Dostępne są bezpieczniejsze wersje niektórych z tych funkcji; zobacz sprintf_s, , swprintf_s_sprintf_s_l, , _swprintf_s_l. Bezpieczne wersje swprintf i _swprintf_l przyjmują rozmiar buforu jako parametr.

Składnia

int sprintf(
   char *buffer,
   const char *format [,
   argument] ...
);

int _sprintf_l(
   char *buffer,
   const char *format,
   _locale_t locale [,
   argument] ...
);

int swprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format [,
   argument]...
);

int _swprintf(
   wchar_t *buffer,
   const wchar_t *format [,
   argument]...
);

int _swprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   _locale_t locale [,
   argument] ...
);

int __swprintf_l(
   wchar_t *buffer,
   const wchar_t *format,
   _locale_t locale [,
   argument] ...
);

template <size_t size>
int sprintf(
   char (&buffer)[size],
   const char *format [,
   argument] ...
); // C++ only

template <size_t size>
int _sprintf_l(
   char (&buffer)[size],
   const char *format,
   _locale_t locale [,
   argument] ...
); // C++ only

Parametry

buffer
Lokalizacja magazynu dla danych wyjściowych

count
Maksymalna liczba znaków do przechowywania w wersji Unicode tej funkcji.

format
Ciąg kontrolki formatu

argument
Argumenty opcjonalne

locale
Ustawienia regionalne do użycia.

Aby uzyskać więcej informacji, zobacz Składnia specyfikacji formatu.

Wartość zwracana

Liczba zapisanych znaków lub -1, jeśli wystąpił błąd. Jeśli buffer lub format jest wskaźnikiem o wartości null, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Walidacja parametru. Jeśli wykonanie może kontynuować, te funkcje zwracają wartość -1 i ustawiają wartość errno EINVAL.

sprintf Zwraca liczbę bajtów przechowywanych w bufferobiekcie , która nie zlicza znaku null zakończenia. swprintf Zwraca liczbę znaków szerokich przechowywanych w bufferobiekcie , która nie zlicza znaku szerokiego o wartości null zakończenia.

Uwagi

Funkcja sprintf formatuje i przechowuje serię znaków i wartości w pliku buffer. Każda argument (jeśli istnieje) jest konwertowana i wyjściowa zgodnie z odpowiednią specyfikacją formatu w pliku format. Format składa się ze zwykłych znaków i ma taką samą formę i funkcję jak format argument dla printfelementu . Znak null jest dołączany po zapisaniu ostatniego znaku. Jeśli kopiowanie odbywa się między nakładającymi się ciągami, zachowanie jest niezdefiniowane.

Ważne

Przy użyciu metody sprintfnie ma możliwości ograniczenia liczby zapisanych znaków, co oznacza, że kod używający metody sprintf jest podatny na przepełnienie buforu. Rozważ użycie powiązanej funkcji snprintf, która określa maksymalną liczbę znaków do zapisania w bufferpliku , lub użyj _scprintf polecenia , aby określić, jak duży bufor jest wymagany. Upewnij się również, że format nie jest ciągiem zdefiniowanym przez użytkownika.

Począwszy od systemu Windows 10 w wersji 2004 (kompilacja 19041), printf rodzina funkcji drukuje dokładnie możliwe liczby zmiennoprzecinkowe zgodnie z regułami IEEE 754 dotyczącymi zaokrąglania. W poprzednich wersjach systemu Windows dokładnie reprezentowane liczby zmiennoprzecinkowe kończące się na "5" zawsze zaokrągla się w górę. IEEE 754 stwierdza, że muszą zaokrąglić do najbliższej parzysta cyfra (znana również jako "Zaokrąglanie Bankiera"). Na przykład oba printf("%1.0f", 1.5) printf("%1.0f", 2.5) elementy i powinny być zaokrąglone do 2. Wcześniej 1,5 zaokrągliłoby się do 2 i 2,5 do 3. Ta zmiana dotyczy tylko dokładnie możliwych do reprezentowania liczb. Na przykład 2,35 (który, gdy jest reprezentowany w pamięci, jest bliżej 2,350000000000000008) nadal zaokrągla się do 2,4. Zaokrąglanie wykonywane przez te funkcje jest teraz również zgodne z trybem zaokrąglania zmiennoprzecinkowego ustawionym przez fesetround. Wcześniej zaokrąglanie zawsze wybierało FE_TONEAREST zachowanie. Ta zmiana dotyczy tylko programów utworzonych przy użyciu programu Visual Studio 2019 w wersji 16.2 lub nowszej. Aby użyć starszego zachowania zaokrąglania zmiennoprzecinkowego, połącz się z elementem "legacy_stdio_float_rounding.obj".

swprintf jest wersją sprintfwieloznakową ; argumenty wskaźnika do swprintf są ciągami o szerokim znaku. Wykrywanie błędów kodowania w swprintf pliku może różnić się od sprintf. swprintf i fwprintf zachowuje się identycznie, z wyjątkiem swprintf zapisu danych wyjściowych w ciągu, a nie do miejsca docelowego typu FILE, i swprintf wymaga parametru count , aby określić maksymalną liczbę znaków do zapisania. Wersje tych funkcji z sufiksem _l są identyczne, z wyjątkiem używania parametru ustawień regionalnych przekazanych zamiast bieżących ustawień regionalnych wątku.

Przed standaryzacją podpisu swprintf wersja dostarczona w starszej bibliotece środowiska uruchomieniowego języka Microsoft C, która nie miała parametru liczby znaków. Starsza wersja jest nadal dostępna w bibliotece środowiska uruchomieniowego microsoft C, ale jest przestarzała i została zmieniona na _swprintf(). W przypadku kodu napisanego względem starszego podpisu zdefiniuj _CRT_NON_CONFORMING_SWPRINTFSelement , który mapuje wywołania na swprintf _swprintf. W przyszłej wersji stare zachowanie może zostać usunięte, dlatego należy zmienić kod tak, aby używał nowego zachowania zgodnego.

W języku C++te funkcje mają przeciążenia szablonu, które wywołują nowsze, bezpieczne odpowiedniki tych funkcji. Aby uzyskać więcej informacji, zobacz Bezpieczne przeciążenia szablonów.

Mapowania procedur tekstu ogólnego

TCHAR.H rutyna	_UNICODE i _MBCS niezdefiniowane	_MBCS zdefiniowany	_UNICODE zdefiniowany
_stprintf	sprintf	sprintf	_swprintf
_stprintf_l	_sprintf_l	_sprintf_l	__swprintf_l

Wymagania

Procedura	Wymagany nagłówek
sprintf, _sprintf_l	<stdio.h>
swprintf, , _swprintf_swprintf_l	<stdio.h> lub <wchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład: służy sprintf do formatowania danych

// crt_sprintf.c
// compile with: /W3
// This program uses sprintf 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( buffer,     "   String:    %s\n", s ); // C4996
   j += sprintf( buffer + j, "   Character: %c\n", c ); // C4996
   j += sprintf( buffer + j, "   Integer:   %d\n", i ); // C4996
   j += sprintf( buffer + j, "   Real:      %f\n", fp );// C4996
   // Note: sprintf is deprecated; consider using sprintf_s instead

   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łędu

// crt_swprintf.c
// wide character example
// also demonstrates swprintf returning error code
#include <stdio.h>

int main( void )
{
   wchar_t buf[100];
   int len = swprintf( buf, 100, L"%s", L"Hello world" );
   printf( "wrote %d characters\n", len );
   len = swprintf( buf, 100, L"%s", L"Hello\xffff world" );
   // swprintf fails because string contains WEOF (\xffff)
   printf( "wrote %d characters\n", len );
}

wrote 11 characters
wrote -1 characters

Zobacz też

We/Wy strumienia
fprintf, , _fprintf_l, , fwprintf_fwprintf_l
printf, , _printf_l, , wprintf_wprintf_l
scanf, , _scanf_l, , wscanf_wscanf_l
sscanf, , _sscanf_l, , swscanf_swscanf_l
vprintf, funkcje