_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Článek
03/04/2013

Vrátí počet znaků v formátovaný řetězec umožňuje určit pořadí, ve kterém jsou použity parametry řetězce formátu.

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
Řetězec formátu řízení.
argument
Volitelné argumenty.
locale
Národní prostředí použít.

Vrácená hodnota

Vrátí počet znaků, které by generována, pokud řetězec vytisknout nebo odeslat soubor nebo zadaný formátovací kódy pomocí vyrovnávací paměti.Vrácená hodnota nezahrnuje ukončujícím znakem null._scwprintf_pmá stejnou funkci pro širokou znaky.

Rozdíl mezi _scprintf_p a _scprintf je _scprintf_p podporuje poziční parametry, které umožňuje určení pořadí, ve kterém jsou použity argumenty ve formátu řetězce.Další informace naleznete v tématu printf_p poziční parametry.

Pokud format je NULL vyvolat ukazatel neplatný parametr popisovače, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, vrátí tyto funkce hodnotu -1 a errno na EINVAL.

Informace o těchto a jiných kódů chyb naleznete v tématu _doserrno, kód chyby, _sys_errlist a _sys_nerr.

Poznámky

Každý argument (pokud existuje) se převede podle odpovídající specifikaci formátu v format.Formát se skládá z běžných znaků a má stejný formulář a fungovat jako format argument pro printf.

Verze těchto funkcí se _l přípony jsou shodné s výjimkou, že používají národní prostředí parametr předaný namísto aktuální podproces národní prostředí.