_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l

Makale
03/26/2013

Okuma konsol verileri biçimlendirilmiş.Bunlar daha güvenli sürümlerini _cscanf, _cscanf_l, _cwscanf, _cwscanf_l açıklandığı gibi güvenlik geliştirmeleri ile crt güvenlik özellikleri.

Önemli
Bu API, Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

int _cscanf_s( 
   const char *format [,
   argument] ... 
);
int _cscanf_s_l( 
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _cwscanf_s( 
   const wchar_t *format [,
   argument] ... 
);
int _cwscanf_s_l( 
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Parametreler

format
Denetimi Biçimlendir dize.
argument
İsteğe bağlı parametreler.
locale
Kullanılacak yerel ayarı.

Dönüş Değeri

Başarılı bir şekilde dönüştürülür ve atanan alan sayısı.Dönüş değerini okuyabilir ancak atanmamış alanları içermez.Dönüş değeri EOF için dosya sonu okuma girişimi.Bu komut satırı işletim sistemi düzeyinde klavye girişi yeniden yönlendirildiğinde oluşabilir.Dönüş değeri, hiçbir alan atanmış olan 0 anlamına gelir.

Bu işlevler, kendi parametrelerini doğrulayın.format Bir null işaretçi parametresi geçersiz işleyici açıklandığı gibi bu işlevleri çağırma Parametre doğrulama.Yürütülmesine devam etmek için izin verilip verilmediğini, bu işlevler dönmek EOF ve errno ayarlamak EINVAL.

Notlar

_cscanf_s İşlevi tarafından verilen konumları içine doğrudan konsoldan verileri okur argument._Getche karakterleri okuyacak şekilde işlevi kullanılır.Her isteğe bağlı parametre türü belirticisi karşılık gelen bir türü olan bir değişken için bir işaretçi olmalıdır format.Yorumunu giriş alanları ve aynı biçimi denetimlerini form ve işlev olarak format parametresi için scanf_s işlev.Sırada _cscanf_s giriş karakteri normal olarak Yankı son çağrı yapmak ise, bunu yapmaz _ungetch.

Gibi diğer işlevler güvenli sürümleriniscanf ailesi, _cscanf_s ve _cswscanf_s boyut türü alan karakterleri bağımsız değişkenleri gerektirir c, C, s, S, ve [.Daha fazla bilgi için bkz. scanf genişlik belirtimi.

[!NOT]

Boyut parametresi türüdür unsigneddeğil size_t.

Bu işlevleri sürümlerini _l sonek dışında geçerli iş parçacığı yerel geçirilen yerel ayar parametresi kullandıkları aynı.

Genel metin eşlemeleri yordamına girildi

TCHAR.H yordamına girildi	_UNICODE ve _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_tcscanf_s	_cscanf_s	_cscanf_s	_cwscanf_s
_tcscanf_s_l	_cscanf_s_l	_cscanf_s_l	_cwscanf_s_l

Gereksinimler

Yordamı	Gerekli başlık
_cscanf_s,_cscanf_s_l	<conio.h>
_cwscanf_s, _cwscanf_s_l	<conio.h> veya <wchar.h>

Daha fazla uyumluluk bilgileri için bkz: Uyumluluk giriş.

Kitaplıkları

Tüm sürümleri c çalışma zamanı kitaplıkları.

Örnek

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

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

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

   result = _cscanf_s( "%i %i %i", &n[0], &n[1], &n[2] );
   _cprintf_s( "\r\nYou entered " );
   for( i=0; i<result; i++ )
      _cprintf_s( "%i ", n[i] );
   _cprintf_s( "\r\n" );
}