Serwis Edukacyjny
Nauczycieli
w I-LO w Tarnowie
obrazek

Materiały dla uczniów liceum

  Wyjście       Spis treści       Wstecz       Dalej  

Autor artykułu: mgr Jerzy Wałaszek
Uaktualniono: 31.07.2022

©2024 mgr Jerzy Wałaszek
I LO w Tarnowie

Interfejs SDL2:

SDL_PeepEvents

SPIS TREŚCI

Rozdział jest tłumaczeniem oryginalnej instrukcji dla biblioteki SDL2.

SDL_PeepEvents

Użyj tej funkcji, aby sprawdzić, czy w kolejce zdarzeń są jakieś wiadomości i opcjonalnie zwrócić je.

Składnia

int SDL_PeepEvents(SDL_Event*      events,
                   int             numevents,
                   SDL_eventaction action,
                   Uint32          minType,
                   Uint32          maxType)

Parametry funkcji

events bufor docelowy dla pobranych zdarzeń .
numevents jeśli działaniem jest dodawanie zdarzeń SDL_ADDEVENT, to jest to liczba zdarzeń do dodania do kolejki zdarzeń; jeśli działaniem jest podgląd zdarzeń SDL_PEEKEVENT lub pobieranie zdarzeń SDL_GETEVENT, to jest to maksymalna liczba zdarzeń do pobrania.
action rodzaj działania; zobacz do Uwag.
minType minimalna wartość typu zdarzenia, które należy wziąć pod uwagę; bezpiecznym wyborem jest SDL_FIRSTEVENT.
maxType maksymalna wartość typu zdarzenia, które należy wziąć pod uwagę; bezpiecznym wyborem jest SDL_LASTEVENT.

Wartość zwracana

Zwraca liczbę zdarzeń faktycznie zapisanych lub ujemny kod błędu przy niepowodzeniu; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

Uwagi

Parametr action może posiadać jedną z następujących wartości:

SDL_ADDEVENT do liczby numevents zdarzeń zostanie dodanych na koniec kolejki zdarzeń.
SDL_PEEKEVENT do liczby numevents zdarzeń na początku kolejki zdarzeń z określoną minimalną i maksymalną wartością typu zostanie zwrócone, lecz nie będą one usunięte z kolejki.
SDL_GETEVENT do liczby numevents zdarzeń na początku kolejki zdarzeń z określoną minimalną i maksymalną wartością typu zostanie zwrócone i usunięte z kolejki.

Ta funkcja jest bezpieczna wątkowo.

Możesz potrzebować wywołać SDL_PumpEvents() przed wywołaniem tej funkcji. W przeciwnym razie zdarzenia mogą być niegotowe do filtrowania, gdy wywołasz SDL_PeepEvents().

Powiązane funkcje

SDL_PollEvent
SDL_PumpEvents
SDL_PushEvent

Na początek:  podrozdziału   strony 
Zespół Przedmiotowy
Chemii-Fizyki-Informatyki
w I Liceum Ogólnokształcącym
im. Kazimierza Brodzińskiego
w Tarnowie
ul. Piłsudskiego 4
©2024 mgr Jerzy Wałaszek

Materiały tylko do użytku dydaktycznego. Ich kopiowanie i powielanie jest dozwolone
pod warunkiem podania źródła oraz niepobierania za to pieniędzy.

Pytania proszę przesyłać na adres email: i-lo@eduinf.waw.pl

Serwis wykorzystuje pliki cookies. Jeśli nie chcesz ich otrzymywać, zablokuj je w swojej przeglądarce.

Informacje dodatkowe.