qa_usuba.c File Reference

QActive_unsubscribeAll() definition. More...

#include "qf_pkg.h"
#include "qassert.h"

Go to the source code of this file.

Functions
void	QActive_unsubscribeAll (QActive const *me)
	Un-subscribes from the delivery of all signals to the active object me.

---

Detailed Description

QActive_unsubscribeAll() definition.

Definition in file qa_usuba.c.

---

Function Documentation

void QActive_unsubscribeAll

(

QActive const *

me

)

Un-subscribes from the delivery of all signals to the active object me.

This function is part of the Publish-Subscribe event delivery mechanism available in QF. Un-subscribing from all events means that the framework will stop posting any published events to the event queue of the active object me.

Note:

Due to the latency of event queues, an active object should NOT assume that no events will ever be dispatched to the state machine of the active object after un-subscribing from all events. The events might be already in the queue, or just about to be posted and the un-subscribe operation will not flush such events. Also, the alternative event-delivery mechanisms, such as direct event posting or time events, can be still delivered to the event queue of the active object.

See also:

QF_publish(), QActive_subscribe(), and QActive_unsubscribe()

Definition at line 40 of file qa_usuba.c.

References QSubscrList::bits, Q_REQUIRE, Q_ROM_BYTE, Q_USER_SIG, QF_active_, QF_div8Lkup, QF_invPwr2Lkup, QF_MAX_ACTIVE, QF_maxSignal_, QF_pwr2Lkup, QF_subscrList_, QS_aoObj_, QS_BEGIN_NOLOCK_, QS_END_NOLOCK_, QS_OBJ_, QS_QF_ACTIVE_UNSUBSCRIBE, and QS_SIG_.