_snscanf
, , _snscanf_l
, , _snwscanf
_snwscanf_l
Odczytuje sformatowane dane o określonej długości z ciągu. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz _snscanf_s
, , _snwscanf_s
_snscanf_s_l
, , _snwscanf_s_l
.
Składnia
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,
...
);
Parametry
input
Ciąg wejściowy do zbadania.
length
Liczba znaków do zbadania w pliku input
.
format
Co najmniej jeden specyfikator formatu.
...
Opcjonalne zmienne, które będą używane do przechowywania wartości wyodrębnionych z ciągu wejściowego przez specyfikatory formatu w pliku format
.
locale
Ustawienia regionalne do użycia.
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 sscanf
.
Jeśli input
wskaźnik lub format
jest wskaźnikiem NULL
lub length
jest mniejszy lub równy zero, 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ść errno
EINVAL
.
Aby uzyskać informacje o tych i innych kodach błędów, zobacz errno
, _doserrno
, _sys_errlist
i _sys_nerr
.
Uwagi
Ta funkcja jest podobna do sscanf
, 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 sscanf
.
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 zdefiniowany |
_UNICODE zdefiniowany |
---|---|---|---|
_sntscanf |
_snscanf |
_snscanf |
_snwscanf |
_sntscanf_l |
_snscanf_l |
_snscanf_l |
_snwscanf_l |
Wymagania
Procedura | Wymagany nagłówek |
---|---|
_snscanf , _snscanf_l |
<stdio.h> |
_snwscanf , _snwscanf_l |
<stdio.h> lub <wchar.h> |
Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.
Przykład
// 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