Поделиться через

vscanf_s, vwscanf_s

  • Статья

Считывает отформатированные данные из стандартного входного потока. Эти версии имеют vwscanfулучшения безопасности, как описано в функциях vscanfбезопасности в CRT.

Синтаксис

int vscanf_s(
   const char *format,
   va_list arglist
);
int vwscanf_s(
   const wchar_t *format,
   va_list arglist
);

Параметры

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

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

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

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

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

Замечания

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

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

В отличие vscanf от и vwscanf, vscanf_s и vwscanf_s требуется, чтобы размер буфера был указан для всех входных параметров типа C, C, S, S или строковых элементов управления, заключенных в []. Размер буфера в символах передается как другой параметр сразу после указателя на буфер или переменную. Размер буфера в символах строки wchar_t не совпадает с размером в байтах.

Размер буфера включает завершающее значение NULL. Можно использовать поле спецификации ширины, чтобы гарантировать, что считываемый токен поместится в буфер. Если поле спецификации ширины не используется, а чтение маркера слишком велико для размещения в буфере, ничего не записывается в этот буфер.

Примечание.

Параметр size имеет тип unsigned, а не size_t.

Дополнительные сведения см. в разделе Спецификация ширины scanf.

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

Подпрограмма TCHAR.H _UNICODE и _MBCS не определен _MBCS Определенные _UNICODE Определенные
_vtscanf_s vscanf_s vscanf_s vwscanf_s

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

Требования

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

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

Пример

// crt_vscanf_s.c
// compile with: /W3
// This program uses the vscanf_s and vwscanf_s functions
// to read formatted input.

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

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

int call_vwscanf_s(wchar_t *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vwscanf_s(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_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 = call_vwscanf_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);
}

Если эта программа получает входные данные, показанные в примере, она создает следующий результат:

71 98.6 h z Byte characters
36 92.3 y n Wide characters

The 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

См. также

Поддержка математических и плавающих точек
Потоковый ввод-вывод
Локаль
printf, , _printf_lwprintf_wprintf_l
scanf, , _scanf_lwscanf_wscanf_l
scanf_s, , _scanf_s_lwscanf_s_wscanf_s_l
vscanf, vwscanf