create_eventT_create_eventCreateEventCreateEventcreate_event (Operator)
Name
create_eventT_create_eventCreateEventCreateEventcreate_event — Erzeugen eines Event-Synchronisationsobjektes.
Signatur
void CreateEvent(const HTuple& AttribName, const HTuple& AttribValue, HTuple* EventHandle)
void HEvent::HEvent(const HTuple& AttribName, const HTuple& AttribValue)
void HEvent::HEvent(const HString& AttribName, const HString& AttribValue)
void HEvent::HEvent(const char* AttribName, const char* AttribValue)
void HEvent::HEvent(const wchar_t* AttribName, const wchar_t* AttribValue)
(Nur Windows)
void HEvent::CreateEvent(const HTuple& AttribName, const HTuple& AttribValue)
void HEvent::CreateEvent(const HString& AttribName, const HString& AttribValue)
void HEvent::CreateEvent(const char* AttribName, const char* AttribValue)
void HEvent::CreateEvent(const wchar_t* AttribName, const wchar_t* AttribValue)
(Nur Windows)
def create_event(attrib_name: MaybeSequence[Union[int, float, str]], attrib_value: MaybeSequence[Union[int, float, str]]) -> HHandle
Beschreibung
Ein Event ist ein Mutex, der keinem Thread gehört. D.h., er kann von einem
anderen Thread freigegeben werden als von dem, der ihn gesperrt hat. Daher
werden Events meist dann eingesetzt, wenn ein Thread einem anderem,
wartenden Thread signalisieren soll, dass dieser weiterlaufen kann. Dieses
Verständnis von Events leitet sich aus der Definition eines Events der
WIN32-API oder der einer Semaphore (mit Zähler 0) der
POSIX-Thread-Spezifikation ab.
create_eventcreate_eventCreateEventCreateEventCreateEventcreate_event legt ein Eventobjekt an und initialisiert es
entsprechend der Attribute,
die über die Parameter AttribNameAttribNameAttribNameAttribNameattribNameattrib_name und AttribValueAttribValueAttribValueAttribValueattribValueattrib_value
gesetzt werden. AttribNameAttribNameAttribNameAttribNameattribNameattrib_name definiert die Klasse und
AttribValueAttribValueAttribValueAttribValueattribValueattrib_value den Typ des Events. Im Folgenden werden die möglichen
Attributwerte für die gelisteten Attributnamen beschrieben:
- ''""""""""""
der leere String setzt die Standardattribute.
- 'type'"type""type""type""type""type"
-
spezifiziert das Verhalten eines Events, wenn ein
Thread auf ein Signal warten muss:
- 'sleep'"sleep""sleep""sleep""sleep""sleep"
unterbricht den aufrufenden Thread und legt ihn
schlafen (Standard).
- 'spin'"spin""spin""spin""spin""spin"
ist die schnelle Implementierung eines Events,
die in einer Schleife auf die Signalisierung des Events wartet. Dieser
Typ ist nicht rekursiv.
Nach der Initialisierung ist ein Event gesperrt.
Ausführungsinformationen
- Multithreading-Typ: independent (läuft parallel auch zu exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
AttribNameAttribNameAttribNameAttribNameattribNameattrib_name (input_control) attribute.name(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Event-Attribut.
Defaultwert: []
Werteliste: 'type'"type""type""type""type""type"
AttribValueAttribValueAttribValueAttribValueattribValueattrib_value (input_control) attribute.value(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Event-Attributwert.
Parameteranzahl: AttribValue == AttribName
Defaultwert: []
Werteliste: 'sleep'"sleep""sleep""sleep""sleep""sleep", 'spin'"spin""spin""spin""spin""spin"
EventHandleEventHandleEventHandleEventHandleeventHandleevent_handle (output_control) event → HEvent, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Event-Synchronisationsobjekt.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert create_eventcreate_eventCreateEventCreateEventCreateEventcreate_event
den Wert TRUE. Gegebenenfalls
wird eine Fehlerbehandlung durchgeführt.
Nachfolger
wait_eventwait_eventWaitEventWaitEventWaitEventwait_event,
signal_eventsignal_eventSignalEventSignalEventSignalEventsignal_event,
clear_eventclear_eventClearEventClearEventClearEventclear_event
Siehe auch
clear_eventclear_eventClearEventClearEventClearEventclear_event
Modul
Foundation