scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l

Článek
03/26/2013

Čtení formátovaných dat ze standardního vstupního datového proudu.Jedná se o verze scanf, _scanf_l, wscanf, _wscanf_l s vylepšení zabezpečení, jak je popsáno v Funkce zabezpečení v CRT.

int scanf_s(
   const char *format [,
   argument]... 
);
int _scanf_s_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int wscanf_s(
   const wchar_t *format [,
   argument]... 
);
int _wscanf_s_l(
   const wchar_t *format,
   locale_t locale [,
   argument]... 
);

Parametry

format
Formátovací řetězec ovládacího prvku.
argument
Volitelné argumenty.
locale
Národní prostředí pro použití.

Vrácená hodnota

Vrátí počet polí úspěšně převeden 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 pro chybu nebo je-li znak konce souboru nebo ukončení řetězce znaků při prvním pokusu o čtení znak.Pokud format je NULL je vyvolán ukazatel, obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů.Je-li pokračovat, je povoleno zpracování scanf_s a wscanf_s vrátit EOF a errno na EINVAL.

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

Poznámky

scanf_s Funkce čte data ze standardního vstupního datového proudu stdin a zapisuje data do umístění dán argument.Každý argument musí být ukazatel na proměnnou typu, který odpovídá specifikátor typu v format.Pokud kopírování probíhá mezi řetězce, které se překrývají, chování není definován.

wscanf_sje verzí širokého znaku scanf_s; format argument wscanf_s je řetězec širokého znaku.wscanf_sa scanf_s chovat identicky identicky, pokud datový proud je otevřen v režimu ANSI.scanf_snepodporuje aktuálně vstup z datového proudu UNICODE.

Verze těchto funkcí se _l přípony jsou shodné s tím rozdílem, že používají parametr locale předaný namísto aktuální národní prostředí pro vlákno.

Unlike scanfand wscanf, scanf_sand wscanf_srequire the buffer size to be specified for all input parameters of type c, C, s, S, or [.Velikost vyrovnávací paměti v znaků je předáno jako další parametr, který bezprostředně následuje ukazatel na vyrovnávací paměti nebo proměnné.Například pokud je čten řetězec, velikost vyrovnávací paměti pro tento řetězec je předán takto:

char s[10];

scanf_s("%9s", s, _countof(s)); // buffer size is 10, width specification is 9

Velikost vyrovnávací paměti zahrnuje ukončující null.Do pole Šířka specifikace lze zajistit, že token v vejde do vyrovnávací paměti.Pokud není pole Šířka specifikace a token číst, je příliš velký a nevejde se do vyrovnávací paměti, nic zapíše do této vyrovnávací paměti.

[!POZNÁMKA]

Typ parametru velikost je unsigned, nikoli size_t.

Následující příklad ukazuje, že parametr velikosti vyrovnávací paměti popisuje maximální počet znaků, ne v bajtech.Při volání wscanf_s, Šířka znaku, který je uveden ve vyrovnávací paměti typu neodpovídá Šířka znaku, který je označen specifikátor formátu.

wchar_t ws[10];
wscanf_s("%9S", ws, _countof(ws));

S Specifikátoru formátu označuje použití šířku znaku, která je "výchozí šířku, který podporuje funkci u".Šířka znaku je jeden bajt, ale funkce podporuje dvoubytové znaky.V tomto příkladu přečte v řetězci 9 znaků single byte celou a umístí je do vyrovnávací paměti double byte celého znaku.Znaky jsou považovány za jednobajtové hodnoty; první dva znaky, které jsou uloženy v ws[0], druhé dva jsou uloženy v ws[1]a tak dále.

V případě znaků jeden může jeden znak nahrazuje tímto:

char c;

scanf_s("%c", &c, 1);

Při čtení více znaků pro jinou hodnotu než null ukončených řetězce, celá čísla se používají jako specifikace šířky a velikost vyrovnávací paměti.

char c[4];

scanf_s("%4c", &c, _countof(c)); // not null terminated

Další informace naleznete v tématu Šířka specifikace scanf.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tscanf_s	scanf_s	scanf_s	wscanf_s
_tscanf_s_l	_scanf_s_l	_scanf_s_l	_wscanf_s_l

Další informace naleznete v tématu polí specifikace formátu – scanf funkcí wscanf a.

Požadavky

Byla zahájena rutina	Požadované záhlaví
scanf_s, _scanf_s_l	<stdio.h>
wscanf_s, _wscanf_s_l	<stdio.h> nebo <wchar.h>

V konzole není podporována v Windows Store apps.Úchyty standardní datový proud přidružené konzoly, stdin, stdout, a stderr, musí být přesměrována před C run-time funkce lze využít v Windows Store apps.Další informace o kompatibilitě, viz Compatibility v úvodu.

Příklad

// crt_scanf_s.c
// This program uses the scanf_s and wscanf_s functions
// to read formatted input.
  
#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   int      i,
            result;
   float    fp;
   char     c,
            s[80];
   wchar_t  wc,
            ws[80];

   result = scanf_s( "%d %f %c %C %s %S", &i, &fp, &c, 1,
                     &wc, 1, s, _countof(s), ws, _countof(ws) );
   printf( "The number of fields input is %d\n", result );
   printf( "The contents are: %d %f %c %C %s %S\n", i, fp, c,
           wc, s, ws);
   result = wscanf_s( L"%d %f %hc %lc %S %ls", &i, &fp, &c, 2,
                      &wc, 1, s, _countof(s), ws, _countof(ws) );
   wprintf( L"The number of fields input is %d\n", result );
   wprintf( L"The contents are: %d %f %C %c %hs %s\n", i, fp,
            c, wc, s, ws);
}