_scprintf, _scprintf_l, _scwprintf, _scwprintf_l

Artykuł
06/09/2015

Zwraca liczbę znaków w sformatowany ciąg.

int _scprintf(
   const char *format [,
   argument] ... 
);
int _scprintf_l(
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _scwprintf(
   const wchar_t *format [,
   argument] ... 
);
int _scwprintf_l(
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Parametry

format
Ciąg formantu formatu.
argument
Argumenty opcjonalne.
locale
Ustawienia regionalne do użycia.

Aby uzyskać więcej informacji na temat ciągów formatujących, zobacz Specyfikacje formatu.

Wartość zwracana

Zwraca liczbę znaków, które można by uzyskać, jakby był mają być drukowane lub wysyłane do pliku lub bufor przy użyciu określonych kodów formatowania.Wartość zwracana nie ma końcowego znaku null._scwprintfpełni tę samą funkcję dla szerokości znaków.

Jeśli format lub NULL, wywoływany jest nieprawidłowy parametr uchwytu, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, te funkcje zwracają wartość -1 i ustawiają errno na EINVAL.

Aby uzyskać informacje na temat tych i innych kodów błędu, zobacz _doserrno, errno, _sys_errlist, and _sys_nerr.

Uwagi

Każdy argument (jeśli istnieje) jest konwertowana zgodnie specyfikacji formatu w format.Format składa się ze znaków zwykłych i ma ten sam formularz i funkcję jak format argument dla printf.

Wersje tych funkcji z przyrostkiem _l są identyczne z wyjątkiem stosowania regionalnych parametrów zamiast bieżącego ciągu.

Uwaga dotycząca zabezpieczeń
Zapewnienia, że format nie jest ciągiem zdefiniowanym przez użytkownika.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE i _MBCS nie zdefiniowany	_MBCS zdefiniowano	_UNICODE zdefiniowany
_sctprintf	_scprintf	_scprintf	_scwprintf
_sctprintf_l	_scprintf_l	_scprintf_l	_scwprintf_l

Wymagania

Procedura	Wymagany nagłówek
_scprintf, _scprintf_l	<stdio.h>
_scwprintf, _scwprintf_l	<stdio.h> lub <wchar.h>

Aby uzyskać więcej informacji na temat zgodności, zobacz Zgodność we Wstępie.

Przykład

// crt__scprintf.c

#define _USE_MATH_DEFINES

#include <stdio.h>
#include <math.h>
#include <malloc.h>

int main( void )
{
   int count;
   int size;
   char *s = NULL;

   count = _scprintf( "The value of Pi is calculated to be %f.\n",
                      M_PI);

   size = count + 1; // the string will need one more char for the null terminator
   s = malloc(sizeof(char) * size);
   sprintf_s(s, size, "The value of Pi is calculated to be %f.\n",
                      M_PI);
   printf("The length of the following string will be %i.\n", count);
   printf("%s", s);
   free( s );
}