_snscanf, _snscanf_l, _snwscanf, _snwscanf_l

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

Синтаксис

int __cdecl _snscanf(
   const char * input,
   size_t length,
   const char * format,
   ...
);
int __cdecl _snscanf_l(
   const char * input,
   size_t length,
   const char * format,
   _locale_t locale,
   ...
);
int __cdecl _snwscanf(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   ...
);
int __cdecl _snwscanf_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   _locale_t locale,
   ...
);

Параметры

input
Входная строка для анализа.

length
Количество символов для анализа в строке input.

format
Один или несколько описателей формата.

...
Необязательные переменные, которые будут использоваться для хранения значений, извлеченных из входной строки с помощью описателей формата.format

locale
Используемый языковой стандарт.

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

Обе эти функции возвращают количество полей, успешно преобразованных и назначенных; Возвращаемое значение не включает поля, которые были прочитаны, но не назначены. Возвращаемое значение 0 указывает, что поля не были назначены. Если до первого преобразования возникает ошибка или достигается конец строки, возвращается значение EOF. Дополнительные сведения см. в разделе sscanf.

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

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

Замечания

Эта функция похожа sscanf, за исключением того, что она позволяет указать фиксированное количество символов для проверки из входной строки. Дополнительные сведения см. в разделе sscanf.

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

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_sntscanf	_snscanf	_snscanf	_snwscanf
_sntscanf_l	_snscanf_l	_snscanf_l	_snwscanf_l

Требования

Маршрут	Обязательный заголовок
_snscanf, _snscanf_l	<stdio.h>
_snwscanf, _snwscanf_l	<stdio.h> или <wchar.h>

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

Пример

// crt_snscanf.c
// compile with: /W3

#include <stdio.h>
int main( )
{
   char  str1[] = "15 12 14...";
   wchar_t  str2[] = L"15 12 14...";
   char  s1[3];
   wchar_t  s2[3];
   int   i;
   float fp;

   i = _snscanf( str1, 6,  "%s %f", s1, &fp); // C4996
   // Note: _snscanf is deprecated; consider using _snscanf_s instead
   printf("_snscanf converted %d fields: ", i);
   printf("%s and %f\n", s1, fp);

   i = _snwscanf( str2, 6,  L"%s %f", s2, &fp); // C4996
   // Note: _snwscanf is deprecated; consider using _snwscanf_s instead
   wprintf(L"_snwscanf converted %d fields: ", i);
   wprintf(L"%s and %f\n", s2, fp);
}

_snscanf converted 2 fields: 15 and 12.000000
_snwscanf converted 2 fields: 15 and 12.000000

См. также

Спецификация ширины scanf