« ReadConsoleInput, funkcja »
Odczytuje dane z bufora wejściowego konsoli i usuwa je z tego bufora. (funkcja)
Logowanie
Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Zapomniałem hasła
Polska dokumentacja C++ » Biblioteki C/C++ » WinAPI » Konsola
Hasło nie zostało zweryfikowane
Niniejsze hasło zostało opracowane, jednak nie zostało ono zweryfikowane przez administrację serwisu. Jeżeli znalazłeś błędy merytoryczne w niniejszym dokumencie, prosimy o ich zgłoszenie na forum w dziale Znalezione błędy.
Opracował: jankowalski25
Biblioteki C/C++

ReadConsoleInput

[funkcja] Odczytuje dane z bufora wejściowego konsoli i usuwa je z tego bufora.

Składnia

C/C++
#include <windows.h>

BOOL WINAPI ReadConsoleInput( HANDLE hConsoleInput, PINPUT_RECORD lpBuffer, DWORD nLength, LPDWORD lpNumberOfEventsRead );

Argumenty

ArgumentOpis
hConsoleInputUchwyt do bufora wejściowego konsoli. Uchwyt musi mieć dostęp GENERIC_READ.
lpBufferWskaźnik do tablicy struktur INPUT_RECORD pobierających dane z bufora wejściowego. Miejsce w pamięci na ten bufor jest alokowane na stercie dla procesów zajmujących 64 KB pamięci. Maksymalny rozmiar bufora zależy od użycia sterty.
nLengthRozmiar tablicy wskazywanej przez argument lpBuffer (liczba elementów tablicy).
lpNumberOfEventsReadWskaźnik na zmienną pobierającą liczbę wczytanych rekordów wejścia.

Zwracana wartość

Jeśli nie wystąpią błędy, zwracana wartość jest niezerowa, inaczej 0. Aby uzyskać szczegółowe informacje o błędzie, wywołaj funkcję » WinAPI ♦ GetLastError.

Dodatkowe informacje

Jeśli liczba rekordów przekracza liczbę rekordów, które bufor może przechowywać, bufor zostanie wypełniony przekazaną ilością rekordów. Jeśli żadne dane nie są dostępne, funkcja zakończy się natychmiast. Ta funkcja używa 8-bitowych znaków Unicode z obecnej strony kodowej konsoli. Domyślna strona kodowa jest stroną kodową OEM. Do zmiany strony kodowej służą funkcje » WinAPI ♦ SetConsoleCP oraz » WinAPI ♦ SetConsoleOutputCP. Można również użyć polecenia
chcp
 lub
mode con cp select=id_strony_kodowej
.

Wymagania

Minimalny system klientaWindows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serweraWindows 2000 Server (tylko aplikacje biurowe).
NagłówekWincon.h (dołącza Windows.h)
BibliotekaKernel32.lib
DLLKernel32.dll
UNICODEReadConsoleInputW
ANSIReadConsoleInputA

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.
Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.
© Wszelkie prawa zastrzeżone 2005-2024