_cgets_s, _cgetws_s
Konsoldan bir karakter dizesini alır.Bu sürümleri _cgets ve _cgetws açıklandığı gibi güvenlik geliştirmeleri, sahip CRT'deki 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üklemeleri.
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.