Konsol Giriş ve Çıkış İşlevlerini High-Level

ReadFile ve WriteFile işlevleri veya ReadConsole ve WriteConsole işlevleri, bir uygulamanın konsol girişini okumasını ve konsol çıkışını karakter akışı olarak yazmasını sağlar. ReadConsole ve WriteConsole tam olarak ReadFile ve WriteFile gibi davranır, ancak bunlar geniş karakter işlevleri (metin bağımsız değişkenlerinin Unicode kullanması gerekir) veya ANSI işlevleri (metin bağımsız değişkenlerinin Windows karakter kümesindeki karakterleri kullanması gerekir) olarak kullanılabilir. Unicode veya ANSI karakter kümesini desteklemek için tek bir kaynak kümesinin korunması gereken uygulamalar ReadConsole ve WriteConsole kullanmalıdır.

ReadConsole ve WriteConsole yalnızca konsol tanıtıcılarıyla kullanılabilir; ReadFile ve WriteFile , diğer tanıtıcılarla (dosyalar veya kanallar gibi) kullanılabilir. ReadConsole ve WriteConsole , yeniden yönlendirilmiş ve artık konsol tanıtıcısı olmayan standart bir tanıtıcıyla kullanıldığında başarısız olur.

Klavye girişi almak için bir işlem, konsolun giriş arabelleğinin tutamacı ile ReadFile veya ReadConsole kullanabilir veya yeniden yönlendirildiyse STDIN dosyadan veya kanaldan girişi okumak için ReadFile kullanabilir. Bu işlevler yalnızca ANSI veya Unicode karakterlerine çevrilebilen klavye olaylarını döndürür. Döndürülebilecek giriş, denetim tuşu bileşimlerini içerir. İşlevler, işlev tuşlarını veya ok tuşlarını içeren klavye olaylarını döndürmez. Fare, pencere, odak veya menü girişi tarafından oluşturulan giriş olayları atılır.

Satır giriş modu etkinse (varsayılan mod), Enter tuşuna basılana kadar ReadFile ve ReadConsole çağrı uygulamasına geri dönmez. Satır girişi modu devre dışı bırakılırsa, en az bir karakter kullanılabilir olana kadar işlevler döndürülemez. Her iki modda da, artık kullanılabilir anahtar kalmayıncaya veya belirtilen sayıda karakter okunana kadar tüm kullanılabilir karakterler okunur. Okunmamış karakterler bir sonraki okuma işlemine kadar arabelleğe alınıyor. İşlevler, gerçekte okunan toplam karakter sayısını bildirir. Yankı giriş modu etkinse, bu işlevler tarafından okunan karakterler geçerli imleç konumundaki etkin ekran arabelleğine yazılır.

Bir işlem etkin veya etkin olmayan bir ekran arabelleğine yazmak için WriteFile veya WriteConsole kullanabilir ya da STDOUT yeniden yönlendirildiyse dosyaya veya kanala yazmak için WriteFile kullanabilir. İşlenen çıkış modu ve EOL çıkış modunda kaydırma, karakterlerin bir ekran arabelleğine yazılma veya yankılama şeklini denetler.

WriteFile veya WriteConsole tarafından yazılan veya ReadFile veyaReadConsole tarafından yankılanan karakterler, geçerli imleç konumundaki bir ekran arabelleğine eklenir. Her karakter yazıldıkçe, imleç konumu sonraki karakter hücresine ilerler; ancak satırın sonundaki davranış, konsol ekranı arabelleğinin EOL çıkış modunda sarmalama durumuna bağlıdır.

İmlecin konumu hakkında daha fazla ayrıntı sanal terminal dizileri aracılığıyla, özellikle geçerli konumu bulmak için sorgu durumu kategorisinde ve geçerli konumu ayarlamak için imleç konumlandırma kategorisinde bulunabilir. Alternatif olarak, bir uygulama geçerli imleç konumunu belirlemek için GetConsoleScreenBufferInfo işlevini ve imleç konumunu ayarlamak için SetConsoleCursorPosition işlevini kullanabilir. Ancak tüm yeni ve devam eden geliştirmeler için sanal terminal dizileri mekanizması tercih edilir. Bu kararın arkasındaki strateji hakkında daha fazla ayrıntı , klasik işlevlerle sanal terminal ve ekosistem yol haritası belgelerinde bulunabilir.

Üst düzey konsol G/Ç işlevlerini kullanan bir örnek için bkz. High-Level Giriş ve Çıkış İşlevlerini Kullanma.