scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l

Článek
06/09/2015

Čtení formátovaných dat ze standardního vstupního proudu.Tyto verze scanf, _scanf_l, wscanf, _wscanf_l mají rozšíření zabezpečení popsaná v tématu 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
Řetězec řízení formátu.
argument
Volitelné argumenty.
locale
Použité národní prostředí.

Vrácená hodnota

Vrátí počet polí úspěšně převedených a přidělených; vrácená hodnota nezahrnuje pole, která byla načtena, ale která nejsou přiřazena.Vrácená hodnota 0 označuje, že nebyla přiřazena žádná pole.Vrácená hodnota je EOF pro chybu, nebo je-li přečten znak konce souboru nebo znak ukončení řetězce při prvním pokusu o čtení znaku.Pokud je format ukazatel NULL, je vyvolán neplatný parametr obslužné rutiny, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, scanf_s a wscanf_s vrátí EOF a nastaví errno na EINVAL.

Další informace o tomto a dalších chybových kódech naleznete v tématu errno, _doserrno, _sys_errlist, and _sys_nerr.

Poznámky

Funkce scanf_s načte data ze standardního vstupního proudu stdin a zapíše data do umístění, které je dáno argumentem argument.Každý argument musí ukazovat na proměnnou s typem, který odpovídá specifikátoru typu v format.Pokud ke kopírování dojde mezi řetězci, které se překrývají, chování není definováno.

wscanf_s je širokoznaká verze scanf_s; argument format pro wscanf_s je širokoznaký řetězec.wscanf_s a scanf_s se chovají stejně jako v případě, že datový proud je otevřen v režimu ANSI.scanf_s aktuálně nepodporuje vstup z datového proudu UNICODE.

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

Na rozdíl od scanf a wscanf, scanf_s a wscanf_s vyžadují velikost vyrovnávací paměti, která má být určena pro všechny vstupní parametry typu c, C, s, Snebo sad řízení řetězců, které jsou uzavřeny v [].Velikost vyrovnávací paměti ve znacích je předána jako další parametr ihned po ukazateli do vyrovnávací paměti nebo proměnné.Například při čtení řetězce je velikost vyrovnávací paměti pro tento řetězec předána takto:

char s[10];

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

Vyrovnávací paměť obsahuje ukončující hodnotu null.Pole pro specifikaci šířky je možné použít k zajištění, že token, který je určen pro čtení, se vejde do vyrovnávací paměti.Pokud není použita žádná specifikace pole „Šířka“ a čtený token je příliš velký a nevejde se do vyrovnávací paměti, do vyrovnávací paměti nebudou zapsána žádná data.

[!POZNÁMKA]

Velikost parametru je typu unsigned, nikoli size_t.

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

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

Specifikátor formátu S určuje použití šířky znaku, což je "opak" výchozí šířky podporované funkcí.Šířka znaku je jeden bajt, ale funkce podporuje dvoubajtové znaky.Tento příklad přečte řetězec o délce až 9 jeden bajt širokých znaků a umístí je do vyrovnávací paměti dva bajty širokých znaků.Znaky jsou považovány za jednobajtové hodnoty. První dva znaky jsou uloženy v ws[0], druhé dva jsou uloženy v ws[1], a tak dále.

V případě znaků může být jeden znak přečten takto:

char c;

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

Při čtení více znaků řetězce neukončeného znakem null, jsou pro určení šířky a velikosti vyrovnávací paměti používána celá čísla.

char c[4];

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

Další informace naleznete v tématu Specifikace šířky scanf.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_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 Pole specifikace formátu: funkce scanf a wscanf.

Požadavky

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

Konzola není v aplikacích Windows Store podporována.Standardní datový proud popisovačů, které jsou spojeny s konzolou – stdin, stdout a stderr, musí být přesměrován před použitím funkcí jazyka C run-time je v aplikacích Windows Store.Další informace o kompatibilitě naleznete v tématu Kompatibilita.

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

Při tomto vstupu program vytvoří následující výstup:

71 98.6 h z Byte characters

36 92.3 y n Wide characters