scanf, _scanf_l, wscanf, _wscanf_l

Статья
04/10/2013

Чтение форматированные данные из стандартного входного потока.Более безопасные версии этих функции доступны; в разделе 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]... 
);

Параметры

format
Строка формата элемента управления.
argument
Необязательные аргументы.
locale
Используемый языковой стандарт.

Возвращаемое значение

Возвращает количество успешно преобразованных и присвоенных полей; возвращаемое значение не включает поля, считанных, но не присвоены.Возвращаемое значение 0 указывает на отсутствие поля не были присвоены.

Если format является NULL, обработчик вызывается недопустимого параметра, как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то функция возвращает EOF и устанавливает errno в EINVAL.

Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.

Заметки

Функция scanf считывает данные из стандартного входного потока stdin и записывает данные в расположение, определяемого argument.Каждый argument должен быть указателем на переменную типа, который соответствует спецификатору типа в format.Если происходит копирование между строками, которые перекрываются, расширения функциональности не определено.

Примечание по безопасности
При чтении строк с scanf, указать ширину для формата %s (например, "%32s" вместо "%s"); в противном случае неправильно отформатированный входных данных легко может вызвать переполнение буфера.Кроме того, можно использовать scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l или fgets.

При чтении строк с scanf, указать ширину для формата %s (например, "%32s" вместо "%s"); в противном случае неправильно отформатированный входных данных легко может вызвать переполнение буфера.Кроме того, можно использовать scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l или fgets.

wscanf двухбайтовая версия scanf; аргумент format для wscanf - строка двухбайтовых знаков.Поведение wscanf и scanf идентично, если поток открыт в режиме ANSI-совместимости.scanf не поддерживает входные данные из потока ЮНИКОДАА.

Версии этих функций с суффиксом _l идентичны, за исключением того, что они используют переданный параметр языкового стандарта вместо текущего языкового стандарта потока.

Универсальное текстовое сопоставление функций

Функция TCHAR.H	неопределенные _UNICODE & _MBCS	определенные _MBCS	Определение _UNICODE
_tscanf	scanf	scanf	wscanf
_tscanf_l	_scanf_l	_scanf_l	_wscanf_l

Дополнительные сведения см. в разделе Поля спецификации формата — функции и функции wscanf scanf.

Требования

Функция	Требуемый заголовок
scanf, _scanf_l	<stdio.h>
wscanf, _wscanf_l	<stdio.h> или <wchar.h>

Консоль не поддерживается в приложениях Магазина Windows.Стандартные дескрипторы потока, связанные с консолью, stdin, stdout и stderr, необходимо перенаправить до функции C времени выполнения могут использовать их в приложениях Магазина Windows.Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Пример

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