_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

Статья
06/09/2015

Считывает форматированные данные указанной длины из строки. Здесь представлены версии _snscanf, _snscanf_l, _snwscanf, _snwscanf_l с усовершенствованной безопасностью, как описано в разделе Функции безопасности в CRT.

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format,
   ...
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   locale_t locale,
   ...
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   ...
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   locale_t locale,
   …
);

Параметры

input
Входная строка для анализа.
length
Количество символов для анализа в input.
format
Один или несколько описателей формата.
... (optional)
Переменные, которые будут использоваться для хранения извлеченных из входной строки значений с помощью описателей формата в format.
locale
Используемый языковой стандарт.

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

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

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

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

Заметки

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

Параметр размера буфера необходимо указывать с символами поля типа c, C, s, S и [. Для получения дополнительной информации см. Символы поля типа scanf.

Примечание

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

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

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определены	_MBCS определено	_UNICODE определено
_sntscanf_s	_snscanf_s	_snscanf_s	_snwscanf_s
_sntscanf_s_l	_snscanf_s_l	_snscanf_s_l	_snwscanf_s_l

Требования

Подпрограмма	Обязательный заголовок
_snscanf_s, _snscanf_s_l	<stdio.h>
_snwscanf_s, _snwscanf_s_l	<stdio.h> или <wchar.h>

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

Пример

// crt_snscanf_s.c
// This example scans a string of 
// numbers, using both the character
// and wide character secure versions
// of the snscanf function.

#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_s( str1, 6,  "%s %f", s1, 3, &fp);
    printf_s("_snscanf_s converted %d fields: ", i);
    printf_s("%s and %f\n", s1, fp);

    i = _snwscanf_s( str2, 6,  L"%s %f", s2, 3, &fp);
    wprintf_s(L"_snwscanf_s converted %d fields: ", i);
    wprintf_s(L"%s and %f\n", s2, fp);
}

Эквивалент в .NET Framework

Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

См. также

Ссылки

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

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