_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

Článek
03/04/2013

Čtení formátu data zadaná délka řetězce.Tyto verze jsou _snscanf, _snscanf_l, _snwscanf, _snwscanf_l s vylepšení zabezpečení popsaným v Funkce zabezpečení v CRT.

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format,
   ...
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   locale_t locale,
   ...
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   ...
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   locale_t locale,
   …
);

Parametry

input
Vstupní řetězec prozkoumat.
length
Počet znaků přezkoumat v input.
format
Jeden nebo více identifikátorů formátu.
... (optional)
Proměnné, které se použije pro uložení hodnot extrahován ze vstupního řetězce formátu specifikátory v format.
locale
Národní prostředí použít.

Vrácená hodnota

Obě tyto funkce vrací počet polí úspěšně převedena a přiřazeny; Vrácená hodnota neobsahuje pole, které byly číst, ale nejsou přiřazeny.Vrácená hodnota 0 označuje, že byla přiřazena žádná pole.Vrácená hodnota je EOF chybová zpráva nebo pokud je dosaženo konce řetězce před prvním převodu.Další informace naleznete v tématu sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

Pokud input nebo 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 EOF 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

Tato funkce se podobá sscanf_s s výjimkou, že poskytuje možnost určit pevný počet znaků zkoumat ze vstupního řetězce.Další informace naleznete v tématu sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

Parametr velikosti vyrovnávací paměti je vyžadován znaky pole typu c, C, s, S, a [.Další informace naleznete v tématu scanf znaky pole Typ.

[!POZNÁMKA]

Typ parametru velikosti je unsigned, není size_t.

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í.

Obecný Text rutinní mapování

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS, definice	_UNICODE, definice
_sntscanf_s	_snscanf_s	_snscanf_s	_snwscanf_s
_sntscanf_s_l	_snscanf_s_l	_snscanf_s_l	_snwscanf_s_l

Požadavky

Rutina	Požadované záhlaví
_snscanf_s, _snscanf_s_l	<stdio.h>
_snwscanf_s, _snwscanf_s_l	<stdio.h> nebo <wchar.h>

Další informace o kompatibilitě v tématu Compatibility v úvodu.

Příklad

// crt_snscanf_s.c
// This example scans a string of 
// numbers, using both the character
// and wide character secure versions
// of the snscanf function.

#include <stdio.h>

int main( )
{
    char        str1[] = "15 12 14...";
    wchar_t     str2[] = L"15 12 14...";
    char        s1[3];
    wchar_t     s2[3];
    int         i;
    float       fp;

    i = _snscanf_s( str1, 6,  "%s %f", s1, 3, &fp);
    printf_s("_snscanf_s converted %d fields: ", i);
    printf_s("%s and %f\n", s1, fp);

    i = _snwscanf_s( str2, 6,  L"%s %f", s2, 3, &fp);
    wprintf_s(L"_snwscanf_s converted %d fields: ", i);
    wprintf_s(L"%s and %f\n", s2, fp);
}

Ekvivalent v rozhraní .NET Framework

Nelze použít Použijte volání funkce standardní C, PInvoke. Další informace naleznete v tématu Příklady vyvolat platformu.

Viz také

Referenční dokumentace

Šířka specifikace scanf

Sdílet prostřednictvím