_cscanf, _cscanf_l, _cwscanf, _cwscanf_l

Artykuł
03/26/2013

Odczyty sformatowane dane z konsoli.Bezpieczniejsze wersje te funkcje są dostępne; see _cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l.

Ważne
Ten interfejs API nie można używać w aplikacji, których wykonywanie w czasie wykonywania systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsługiwane przez /ZW.

int _cscanf( 
   const char *format [,
   argument] ... 
);
int _cscanf_l( 
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _cwscanf( 
   const wchar_t *format [,
   argument] ... 
);
int _cwscanf_l( 
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Parametry

format
Ciąg sterowania formatem.
argument
Parametry opcjonalne.
locale
Ustawienia regionalne używane.

Wartość zwracana

Liczba pól, które zostały pomyślnie przekonwertowane i przypisane.Zwracana wartość nie zawiera pola, które były odczytać, ale nie są przypisane.Wartość zwracana jest EOF dla podjęto próbę odczytu na końcu pliku.Taka sytuacja może wystąpić, gdy przekierowywany jest przy użyciu klawiatury na poziomie wiersza polecenia systemu operacyjnego.Zwracana wartość wynosząca 0 oznacza, że przydzielono żadnych pól.

Uwagi

_cscanf Funkcja odczytuje dane bezpośrednio z konsoli do lokalizacji, biorąc pod uwagę przez argument._Getche funkcja jest używana do odczytu znaków.Każdy parametr opcjonalny musi być wskaźnik do zmiennej o typie, który odpowiada specyfikatora typu w format.Kontrole formacie interpretacji danych wejściowych pola i ma tę samą wartość stanowią i funkcjonować jako format parametr dla scanf funkcji.Podczas gdy _cscanf normalnie echa wprowadzany znak, to nie jest to ostatnie wywołanie była _ungetch.

Ta funkcja sprawdza poprawność jego parametry.Jeśli format ma wartość NULL, moduł obsługi nieprawidłowy parametr jest wywoływana, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, errno jest ustawiona na EINVAL i funkcja zwraca EOF.

Wersje te funkcje za pomocą _l sufiks są identyczne z tym, że używają przekazany zamiast bieżących ustawień regionalnych wątek parametr ustawień regionalnych.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rozpoczęto wykonywanie procedury h	_UNICODE i _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_tcscanf	_cscanf	_cscanf	_cwscanf
_tcscanf_l	_cscanf_l	_cscanf_l	_cwscanf_l

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
_cscanf,_cscanf_l	<conio.h>
_cwscanf, _cwscanf_l	<conio.h> lub <wchar.h>

Informacji dotyczących zgodności, zobacz zgodności we wprowadzeniu.

Przykład

// crt_cscanf.c
// compile with: /c /W3
/* This program prompts for a string
 * and uses _cscanf to read in the response.
 * Then _cscanf returns the number of items
 * matched, and the program displays that number.
 */

#include <stdio.h>
#include <conio.h>

int main( void )
{
   int   result, i[3];

   _cprintf_s( "Enter three integers: ");
   result = _cscanf( "%i %i %i", &i[0], &i[1], &i[2] ); // C4996
   // Note: _cscanf is deprecated; consider using _cscanf_s instead
   _cprintf_s( "\r\nYou entered " );
   while( result-- )
      _cprintf_s( "%i ", i[result] );
   _cprintf_s( "\r\n" );
}

Dane wejściowe

1 2 3

Dane wyjściowe

Enter three integers: 1 2 3
You entered 3 2 1

Zobacz też

Informacje

Konsoli i portów We/Wy

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

fscanf — przetwarza dane, _fscanf_l, fwscanf, _fwscanf_l

scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l

sscanf, _sscanf_l, swscanf, _swscanf_l

Udostępnij za pośrednictwem