scanf, _scanf_l, wscanf, _wscanf_l
Чтение форматированных данных из стандартного входного потока. Существуют более безопасные версии этих функций; см. раздел 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. |
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);
}
Эквивалент в .NET Framework
См. также методы Parse, такие как System::Double::Parse.
См. также
Ссылки
Поддержка чисел с плавающей запятой
fscanf, _fscanf_l, fwscanf, _fwscanf_l
printf, _printf_l, wprintf, _wprintf_l