scanf, _scanf_l, wscanf, _wscanf_l

Článek
03/26/2013

Čtení formátovaných dat ze standardního vstupního datového proudu.Bezpečnější verze tyto funkce jsou k dispozici; see scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l.

int scanf(
   const char *format [,
   argument]... 
);
int _scanf_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int wscanf(
   const wchar_t *format [,
   argument]... 
);
int _wscanf_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.

Pokud format je NULL je vyvolán ukazatel, obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno zpracování, chcete-li pokračovat, tyto funkce vracejí 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 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.

Poznámka k zabezpečení
Při čtení řetězce s scanf, vždy zadejte šířku %s formátu (například "%32s" namísto "%s"); nesprávně formátovaný vstup, v opačném případě se může snadno způsobit přetečení vyrovnávací paměti.Alternativně můžete použít scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l nebo fgets.

wscanfje verzí širokého znaku scanf; format argument wscanf je řetězec širokého znaku.wscanfa scanf chovaly stejně jako v případě, že datový proud je otevřen v režimu ANSI.scanfnepodporuje 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.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tscanf	scanf	scanf	wscanf
_tscanf_l	_scanf_l	_scanf_l	_wscanf_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, _scanf_l	<stdio.h>
wscanf, _wscanf_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.c
// compile with: /W3
 /* This program uses the scanf and wscanf functions
  * to read formatted input.
  */

#include <stdio.h>

int main( void )
{
   int   i, result;
   float fp;
   char  c, s[81];
   wchar_t wc, ws[81];
   result = scanf( "%d %f %c %C %80s %80S", &i, &fp, &c, &wc, s, ws ); // C4996
   // Note: scanf and wscanf are deprecated; consider using scanf_s and wscanf_s
   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( L"%d %f %hc %lc %80S %80ls", &i, &fp, &c, &wc, s, ws ); // C4996
   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);
}