_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

Čte formátovaná data zadané délky z řetězce. Tyto funkce jsou verze _snscanf, _snscanf_l, _snwscanf_snwscanf_ls vylepšeními zabezpečení, jak je popsáno v funkcích zabezpečení v CRT.

Syntaxe

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format [, argument_list]
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   _locale_t locale [, argument_list]
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format [, argument_list]
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   _locale_t locale [, argument_list]
);

Parametry

input
Vstupní řetězec, který chcete prozkoumat.

length
Počet znaků, které se mají prozkoumat v inputsouboru .

format
Jeden nebo více specifikátorů formátu.

locale
Národní prostředí, které se má použít

argument_list
Volitelné argumenty, které mají být přiřazeny podle řetězce formátu.

Vrácená hodnota

Obě tyto funkce vrátí počet polí úspěšně převedených a přiřazených; návratová hodnota neobsahuje pole, která byla přečtená, ale nepřiřazená. Vrácená hodnota 0 označuje, že nebyla přiřazena žádná pole. Vrácená hodnota je EOF pro chybu nebo pokud je dosaženo konce řetězce před prvním převodem. Další informace naleznete v tématu sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

Pokud input nebo format je NULL ukazatel, vyvolá se neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud provádění může pokračovat, tyto funkce se vrátí EOF a nastaví errno na EINVAL.

Informace o těchto a dalších kódech chyb naleznete v tématu , , , a_sys_nerr . _sys_errlist_doserrnoerrno

Poznámky

Tato funkce je podobná sscanf_ss tím rozdílem, že umožňuje zadat pevný počet znaků, které se mají 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 se vyžaduje se znaky pole typu c, C, s, S, S a [. Další informace naleznete v tématu scanf Type Field Characters.

Poznámka

Parametr velikosti je typu unsigned, nikoli size_t.

Verze těchto funkcí s příponou _l jsou shodné s tím rozdílem, že používají parametr národního prostředí předaný místo aktuálního národního prostředí vlákna.

Mapování rutin obecného textu

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS Definovány	_UNICODE Definovány
_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ý hlavičkový soubor
_snscanf_s, _snscanf_s_l	<stdio.h>
_snwscanf_s, _snwscanf_s_l	<stdio.h> nebo <wchar.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

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);
}

_snscanf_s converted 2 fields: 15 and 12.000000
_snwscanf_s converted 2 fields: 15 and 12.000000

Viz také

scanf – specifikace šířky