_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

Odczytuje sformatowane dane o określonej długości z ciągu. Te funkcje to wersje programu _snscanf, _snscanf_l, _snwscanf_l_snwscanf z ulepszeniami zabezpieczeń zgodnie z opisem w temacie Funkcje zabezpieczeń w narzędziu CRT.

Składnia

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format [, argument_list]
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   _locale_t locale [, argument_list]
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format [, argument_list]
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   _locale_t locale [, argument_list]
);

Parametry

input
Ciąg wejściowy do zbadania.

length
Liczba znaków do zbadania w pliku input.

format
Co najmniej jeden specyfikator formatu.

locale
Ustawienia regionalne do użycia.

argument_list
Opcjonalne argumenty, które mają być przypisane zgodnie z ciągiem formatu.

Wartość zwracana

Obie te funkcje zwracają liczbę pól pomyślnie przekonwertowanych i przypisanych; wartość zwracana nie zawiera pól, które zostały odczytane, ale nie zostały przypisane. Wartość zwracana 0 wskazuje, że żadne pola nie zostały przypisane. Wartość zwracana jest EOF dla błędu lub jeśli koniec ciągu zostanie osiągnięty przed pierwszą konwersją. Aby uzyskać więcej informacji, zobacz , , swscanf_s_sscanf_s_l, _swscanf_s_l.sscanf_s

Jeśli input lub format jest wskaźnikiem NULL , wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonanie jest dozwolone do kontynuowania, te funkcje zwracają EOF i ustawiają wartość errnoEINVAL.

Aby uzyskać informacje o tych i innych kodach błędów, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Ta funkcja jest podobna do sscanf_s, z tą różnicą, że umożliwia określenie stałej liczby znaków do zbadania z ciągu wejściowego. Aby uzyskać więcej informacji, zobacz , , swscanf_s_sscanf_s_l, _swscanf_s_l.sscanf_s

Parametr rozmiaru buforu jest wymagany z znakami pól typu c, C, s, S i [. Aby uzyskać więcej informacji, zobacz scanf Type Field Characters (Znaki pola typu scanf).

Uwaga

Parametr rozmiaru jest typu unsigned, a nie size_t.

Wersje tych funkcji z sufiksem _l są identyczne, z tą różnicą, że używają parametru ustawień regionalnych przekazanych zamiast bieżących ustawień regionalnych wątku.

Mapowania procedur tekstu ogólnego

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_sntscanf_s	_snscanf_s	_snscanf_s	_snwscanf_s
_sntscanf_s_l	_snscanf_s_l	_snscanf_s_l	_snwscanf_s_l

Wymagania

Procedura	Wymagany nagłówek
_snscanf_s, _snscanf_s_l	<stdio.h>
_snwscanf_s, _snwscanf_s_l	<stdio.h> lub <wchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

// 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);
}

_snscanf_s converted 2 fields: 15 and 12.000000
_snwscanf_s converted 2 fields: 15 and 12.000000

Zobacz też

scanf, specyfikacje szerokości