_cscanf
, _cscanf_l
, _cwscanf
, _cwscanf_l
Biçimlendirilmiş verileri konsoldan okur. Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. _cscanf_s
, _cscanf_s_l
, _cwscanf_s
. _cwscanf_s_l
Not
Visual Studio 2015'te printf
ve scanf
işlev ailesi olarak inline
bildirildi ve ve <conio.h>
üst bilgilerine <stdio.h>
taşındı. Eski kodu geçiriyorsanız bu işlevlerle bağlantılı olarak Bağlayıcı Hatası LNK2019 görebilirsiniz. Daha fazla bilgi için bkz . Visual C++ değişiklik geçmişi 2003 - 2015.
Önemli
Bu API, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.
Sözdizimi
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] ...
);
Parametreler
format
Biçim denetimi dizesi.
argument
İsteğe bağlı parametreler.
locale
Kullanılacak yerel ayar.
Dönüş değeri
Başarıyla dönüştürülen ve atanan alanların sayısı. Dönüş değeri okunmuş ancak atanmamış alanları içermez. Dönüş değeri, dosyanın sonunda okuma denemesine yöneliktir EOF
. EOF
Klavye girişi işletim sistemi komut satırı düzeyinde yeniden yönlendirildiğinde de döndürülebilir. Sıfır dönüş değeri, hiçbir alanın atanmadığı anlamına gelir.
Açıklamalar
işlevi verileri _cscanf
doğrudan konsolundan tarafından argument
verilen konumlara okur. _getche
İşlev, karakterleri okumak için kullanılır. İsteğe bağlı her parametre, içindeki bir tür tanımlayıcısına format
karşılık gelen bir türe sahip bir değişkene yönelik bir işaretçi olmalıdır. Biçim, giriş alanlarının yorumlanmasını denetler ve işlevin parametresiyle format
aynı forma ve işleve scanf
sahiptir. _cscanf
Normalde giriş karakterini yankılasa da, son çağrı öğesine _ungetch
ise bunu yapmaz.
Bu işlev parametrelerini doğrular. biçim iseNULL
, parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, errno
olarak ayarlanır EINVAL
ve işlevi döndürür EOF
.
Bu işlevlerin sonekli _l
sürümleri aynıdır, ancak geçerli iş parçacığı yerel ayarı yerine geçirilen yerel ayar parametresini kullanırlar.
Genel metin yordamı eşlemeleri
TCHAR.H yordamı | _UNICODE ve _MBCS tanımlanmadı |
_MBCS tanımlanan |
_UNICODE tanımlanan |
---|---|---|---|
_tcscanf |
_cscanf |
_cscanf |
_cwscanf |
_tcscanf_l |
_cscanf_l |
_cscanf_l |
_cwscanf_l |
Gereksinimler
Yordam | Gerekli başlık |
---|---|
_cscanf , _cscanf_l |
<conio.h> |
_cwscanf , _cwscanf_l |
<conio.h> veya <wchar.h> |
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Örnek
// 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" );
}
1 2 3
Enter three integers: 1 2 3
You entered 3 2 1
Ayrıca bkz.
Konsol ve bağlantı noktası G/Ç
_cprintf
, _cprintf_l
, _cwprintf
, _cwprintf_l
fscanf
, _fscanf_l
, fwscanf
, _fwscanf_l
scanf_s
, _scanf_s_l
, wscanf_s
, _wscanf_s_l
sscanf
, _sscanf_l
, swscanf
, _swscanf_l