_cgets_s, _cgetws_s

Makale
03/26/2013

Konsoldan bir karakter dizesini alır.Bu sürümleri _cgets ve _cgetws açıklandığı gibi güvenlik geliştirmeleri, sahip crt güvenlik özellikleri.

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

errno_t _cgets_s( 
   char *buffer,
   size_t numberOfElements,
   size_t *pSizeRead
);
errno_t _cgetws_s(
   wchar_t *buffer
   size_t numberOfElements,
   size_t *pSizeRead
);
template <size_t size>
errno_t _cgets_s( 
   char (&buffer)[size],
   size_t *pSizeRead
); // C++ only
template <size_t size>
errno_t _cgetws_s(
   wchar_t (&buffer)[size],
   size_t *pSizeRead
); // C++ only

Parametreler

[çıkış]buffer
Veri için depolama konumu.
[in]numberOfElements
Okunacak karakter sayısı en fazla olan tek baytlı veya geniş karakter arabelleği boyutu.
[in]pSizeRead
Karakter sayısı gerçekte okuyun.

Dönüş Değeri

Dönüş değeri başarılı olursa sıfırdır; Aksi durumda, bir hata kodu bir hata oluşursa.

Hata koşulları

buffer	numberOfElements	pSizeRead	Return	İçeriğibuffer
NULL	herhangi bir	herhangi bir	EINVAL	yok
değilNULL	sıfır	herhangi bir	EINVAL	modifiye edilmemiş
değilNULL	herhangi bir	NULL	EINVAL	sıfır uzunluklu dize

Notlar

_cgets_sve _cgetws_s dizesiyle (null bir sonlandırıcı) kopyalayın ve konsoldan bir dize okumak buffer._cgetws_sişlev, geniş karakter sürümüdür; Bu iki işlev davranışını karakter boyutu dışında aynıdır.Okunacak dize boyutu üst sınırı olarak geçirilen numberOfElements parametresi.Bu boyut için sonunda boş bir ek karakter içermelidir.Gerçek okuma karakter sayısını yerleştirilir pSizeRead.

Parametreleri doğrulama işlemi sırasında veya bir hata ortaya çıkarsa, geçersiz bir parametre işleyicisi, açıklandığı gibi çağrılır Parametre doğrulama .Yürütülmesine devam etmek için izin verilip verilmediğini errno ayarlamak EINVAL ve EINVAL döndürülür.

C++'da, bu işlevlerin kullanımı tarafından şablon aşırı basitleştirilerek; aşırı yükleme otomatik olarak, böylece size baðýmsýz deðiþkeni belirtmek gereğini ortadan kaldırır arabellek uzunluğu çıkarabilir ve bunlar otomatik olarak daha yeni ve daha güvenli karşılıklarıyla daha eski, daha az güvenli işlevlerini değiştirebilirsiniz.Daha fazla bilgi için bkz. Güvenli şablon aşırı yükleme.

Genel metin eşlemeleri yordamına girildi

Tchar.h yordamına girildi	_UNICODE ve _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_cgetts_s	_cgets_s	_cgets_s	_cgetws_s

Gereksinimler

Yordamı	Gerekli başlık
_cgets_s	<conio.h>
_cgetws_s	<conio.h> veya <wchar.h>

Daha fazla uyumluluk bilgileri için bkz: Uyumluluk.

.NET Framework Eşdeğeri

Yoktur. Standart c işlevi çağırmak için kullanın PInvoke. Daha fazla bilgi için bkz. Platform Çağırma örnekleri.

Ayrıca bkz.

Başvuru

Konsol ve bağlantı noktası g/Ç

_getch, _getwch

Aracılığıyla paylaş