vscanf, vwscanf

Считывает отформатированные данные из стандартного входного потока. Доступны более безопасные версии этих функций; see vscanf_s, vwscanf_s.

Синтаксис

int vscanf(
   const char *format,
   va_list arglist
);
int vwscanf(
   const wchar_t *format,
   va_list arglist
);

Параметры

format
Строка управления форматированием.

arglist
Список аргументов переменных.

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

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

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

Сведения об этих и других кодах ошибок см. в разделе errno, _doserrno_sys_errlistи _sys_nerr.

Замечания

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

Важно!

vscanf При чтении строки всегда указывайте ширину для формата %s (например, "%32s" вместо "%s"). В противном случае неправильно отформатированные входные данные могут привести к переполнению буфера. В качестве альтернативы можно использовать vscanf_svwscanf_sили .fgets

vwscanf — это версия vscanfс расширенными символами; аргумент format для vwscanf — строка расширенных символов. vwscanf и vscanf ведут себя одинаково, если поток открыт в режиме ANSI. vscanf не поддерживает ввод из потока ЮНИКОДА.

Сопоставления подпрограмм универсального текста

Подпрограмма TCHAR.H	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_vtscanf	vscanf	vscanf	vwscanf

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

Требования

Маршрут	Обязательный заголовок
vscanf	<stdio.h>
vwscanf	<stdio.h> или <wchar.h>

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

Пример

// crt_vscanf.c
// compile with: /W3
// This program uses the vscanf and vwscanf functions
// to read formatted input.

#include <stdio.h>
#include <stdarg.h>

int call_vscanf(char *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vscanf(format, arglist);
    va_end(arglist);
    return result;
}

int call_vwscanf(wchar_t *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vwscanf(format, arglist);
    va_end(arglist);
    return result;
}

int main( void )
{
    int   i, result;
    float fp;
    char  c, s[81];
    wchar_t wc, ws[81];
    result = call_vscanf( "%d %f %c %C %80s %80S", &i, &fp, &c, &wc, s, 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 = call_vwscanf( L"%d %f %hc %lc %80S %80ls", &i, &fp, &c, &wc, s, 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);
}

      71 98.6 h z Byte characters
36 92.3 y n Wide charactersThe number of fields input is 6
The contents are: 71 98.599998 h z Byte characters
The number of fields input is 6
The contents are: 36 92.300003 y n Wide characters

См. также

Поддержка математических и плавающих точек
Потоковый ввод-вывод
Локаль
fscanf, _fscanf_l, fwscanf, _fwscanf_l
printf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
sscanf, _sscanf_l, swscanf, _swscanf_l
vscanf_s, vwscanf_s