_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Artykuł
02/27/2013

Zwraca liczbę znaków w ciągu sformatowanych z możliwość określenia kolejności, w której używane są parametry, w ciągu formatu.

int _scprintf_p(
   const char *format [,
   argument] ... 
);
int _scprintf_p_l(
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _scwprintf_p (
   const wchar_t *format [,
   argument] ... 
);
int _scwprintf_p _l(
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Parametry

format
Ciąg formatu formantu.
argument
Opcjonalne argumenty.
locale
Ustawienia regionalne, aby użyć.

Wartość zwracana

Zwraca liczbę znaków, które byłyby wygenerowane, gdyby ciąg mają być drukowane lub wysyłane do pliku lub przy użyciu określonych kodów formatowania buforu.Wartość zwracana nie obejmuje kończącego znaku null._scwprintf_ppełni tę samą funkcję, dla szerokości znaków.

Różnica między _scprintf_p i _scprintf jest to, że _scprintf_p obsługuje parametry pozycyjne, które umożliwia określenie kolejności, w której używane są argumenty w ciągu formatu.Aby uzyskać więcej informacji, zobacz printf_p parametry pozycyjne.

Jeśli format jest NULL obsługi nieprawidłowy parametr wskaźnika jest wywoływany, jak opisano w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje te zwracają wartość -1 i errno do EINVAL.

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

Uwagi

Każdy argument (jeśli ma zastosowanie) jest konwertowana zgodnie z odpowiednich specyfikacji formatu w format.Format składa się ze znaków zwykłych i ma ten sam formularz i działać jako format argument dla printf.

Wersje te funkcje, z _l sufiks są identyczne, z wyjątkiem, że używają oni przekazany zamiast bieżące ustawienia regionalne wątku parametr ustawień regionalnych.