Aracılığıyla paylaş

_cscanf, _cscanf_l, _cwscanf, _cwscanf_l

  • Makale

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 argumentverilen 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 formatkarşı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 _ungetchise 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