ARMmbed
/
mbed-os
mirror of https://github.com/ARMmbed/mbed-os.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

EventQueue.h Doxygen doc fixed up. Moved overloaded callback arguments documentation to overloaded functions to fix warnings. B0..B4 were not documentated additionally, only bulk docs for a0..a4 and c0..c4 were moved around.

pull/4434/head
Kevin Gilbert 2017-06-02 15:11:51 -05:00
parent 1d450f82fb
commit fcc780890c
1 changed files with 57 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
events/EventQueue.h
View File

@ -167,7 +167,6 @@ public:
* events out of irq contexts.
*
* @param f Function to execute in the context of the dispatch loop
* @param a0..a4 Arguments to pass to the callback
* @return A unique id that represents the posted event and can
* be passed to cancel, or an id of 0 if there is not
* enough memory to allocate the event.
@ -186,6 +185,8 @@ public:
/** Calls an event on the queue
* @see EventQueue::call
* @param f Function to execute in the context of the dispatch loop
* @param a0 Argument to pass to the callback
*/
template <typename F, typename A0>
int call(F f, A0 a0) {
@ -194,6 +195,8 @@ public:
/** Calls an event on the queue
* @see EventQueue::call
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1 Arguments to pass to the callback
*/
template <typename F, typename A0, typename A1>
int call(F f, A0 a0, A1 a1) {
@ -202,6 +205,8 @@ public:
/** Calls an event on the queue
* @see EventQueue::call
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2 Arguments to pass to the callback
*/
template <typename F, typename A0, typename A1, typename A2>
int call(F f, A0 a0, A1 a1, A2 a2) {
@ -210,6 +215,8 @@ public:
/** Calls an event on the queue
* @see EventQueue::call
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2,a3 Arguments to pass to the callback
*/
template <typename F, typename A0, typename A1, typename A2, typename A3>
int call(F f, A0 a0, A1 a1, A2 a2, A3 a3) {
@ -218,6 +225,8 @@ public:
/** Calls an event on the queue
* @see EventQueue::call
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2,a3,a4 Arguments to pass to the callback
*/
template <typename F, typename A0, typename A1, typename A2, typename A3, typename A4>
int call(F f, A0 a0, A1 a1, A2 a2, A3 a3, A4 a4) {
@ -425,7 +434,6 @@ public:
* events out of irq contexts.
*
* @param f Function to execute in the context of the dispatch loop
* @param a0..a4 Arguments to pass to the callback
* @param ms Time to delay in milliseconds
* @return A unique id that represents the posted event and can
* be passed to cancel, or an id of 0 if there is not
@ -446,6 +454,9 @@ public:
/** Calls an event on the queue after a specified delay
* @see EventQueue::call_in
* @param ms Time to delay in milliseconds
* @param f Function to execute in the context of the dispatch loop
* @param a0 Argument to pass to the callback
*/
template <typename F, typename A0>
int call_in(int ms, F f, A0 a0) {
@ -454,6 +465,9 @@ public:
/** Calls an event on the queue after a specified delay
* @see EventQueue::call_in
* @param ms Time to delay in milliseconds
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1 Arguments to pass to the callback
*/
template <typename F, typename A0, typename A1>
int call_in(int ms, F f, A0 a0, A1 a1) {
@ -462,6 +476,9 @@ public:
/** Calls an event on the queue after a specified delay
* @see EventQueue::call_in
* @param ms Time to delay in milliseconds
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2 Arguments to pass to the callback
*/
template <typename F, typename A0, typename A1, typename A2>
int call_in(int ms, F f, A0 a0, A1 a1, A2 a2) {
@ -470,6 +487,9 @@ public:
/** Calls an event on the queue after a specified delay
* @see EventQueue::call_in
* @param ms Time to delay in milliseconds
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2,a3 Arguments to pass to the callback
*/
template <typename F, typename A0, typename A1, typename A2, typename A3>
int call_in(int ms, F f, A0 a0, A1 a1, A2 a2, A3 a3) {
@ -478,6 +498,9 @@ public:
/** Calls an event on the queue after a specified delay
* @see EventQueue::call_in
* @param ms Time to delay in milliseconds
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2,a3,a4 Arguments to pass to the callback
*/
template <typename F, typename A0, typename A1, typename A2, typename A3, typename A4>
int call_in(int ms, F f, A0 a0, A1 a1, A2 a2, A3 a3, A4 a4) {
@ -685,7 +708,6 @@ public:
* moving events out of irq contexts.
*
* @param f Function to execute in the context of the dispatch loop
* @param a0..a4 Arguments to pass to the callback
* @param ms Period of the event in milliseconds
* @return A unique id that represents the posted event and can
* be passed to cancel, or an id of 0 if there is not
@ -707,6 +729,9 @@ public:
/** Calls an event on the queue periodically
* @see EventQueue::call_every
* @param f Function to execute in the context of the dispatch loop
* @param a0 Argument to pass to the callback
* @param ms Period of the event in milliseconds
*/
template <typename F, typename A0>
int call_every(int ms, F f, A0 a0) {
@ -715,6 +740,9 @@ public:
/** Calls an event on the queue periodically
* @see EventQueue::call_every
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1 Arguments to pass to the callback
* @param ms Period of the event in milliseconds
*/
template <typename F, typename A0, typename A1>
int call_every(int ms, F f, A0 a0, A1 a1) {
@ -723,6 +751,9 @@ public:
/** Calls an event on the queue periodically
* @see EventQueue::call_every
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2 Arguments to pass to the callback
* @param ms Period of the event in milliseconds
*/
template <typename F, typename A0, typename A1, typename A2>
int call_every(int ms, F f, A0 a0, A1 a1, A2 a2) {
@ -731,6 +762,9 @@ public:
/** Calls an event on the queue periodically
* @see EventQueue::call_every
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2,a3 Arguments to pass to the callback
* @param ms Period of the event in milliseconds
*/
template <typename F, typename A0, typename A1, typename A2, typename A3>
int call_every(int ms, F f, A0 a0, A1 a1, A2 a2, A3 a3) {
@ -739,6 +773,9 @@ public:
/** Calls an event on the queue periodically
* @see EventQueue::call_every
* @param f Function to execute in the context of the dispatch loop
* @param a0,a1,a2,a3,a4 Arguments to pass to the callback
* @param ms Period of the event in milliseconds
*/
template <typename F, typename A0, typename A1, typename A2, typename A3, typename A4>
int call_every(int ms, F f, A0 a0, A1 a1, A2 a2, A3 a3, A4 a4) {
@ -943,11 +980,7 @@ public:
* callback acts as the target for the event and is executed in the
* context of the event queue's dispatch loop once posted.
*
* @param f Function to execute when the event is dispatched
* @param c0..c4 Arguments to bind to the callback, these arguments are
* allocated on an irq-safe allocator from the event queue's
* memory pool. Must be type-compatible with b0..b4, the
* arguments to the underlying callback.
* @param func Function to execute when the event is dispatched
* @return Event that will dispatch on the specific queue
*/
template <typename R>