callInMainThreadHelper

#include <main_thread_callback.h>

Data Structures
class	entry
class	entryVoid

Public Types
typedef pfc::rcptr_t< bool >	killswitch_t

Public Member Functions
	callInMainThreadHelper ()
	~callInMainThreadHelper ()
template<typename host_t , typename arg_t >
void	add (host_t *host, arg_t const &arg)
template<typename host_t >
void	add (host_t *host)
void	add_ (main_thread_callback::ptr cb)
void	shutdown ()

Private Attributes
killswitch_t	m_ks

Detailed Description

Helper class to call methods of your class (host class) in main thread with convenience.
Deals with the otherwise ugly scenario of your class becoming invalid while a method is queued.
Have this as a member of your class, then use m_mthelper.add( this, somearg ) ; to defer a call to this->inMainThread(somearg).
If your class becomes invalid before inMainThread is executed, the pending callback is discarded.
You can optionally call shutdown() to invalidate all pending callbacks early (in a destructor of your class - without waiting for callInMainThreadHelper destructor to do the job.
In order to let callInMainThreadHelper access your private methods, declare friend class callInMainThread.

Definition at line 82 of file main_thread_callback.h.

Member Typedef Documentation

typedef pfc::rcptr_t< bool > callInMainThreadHelper::killswitch_t

Definition at line 85 of file main_thread_callback.h.

Constructor & Destructor Documentation

callInMainThreadHelper::callInMainThreadHelper ( )

inline

Definition at line 123 of file main_thread_callback.h.

                             {
        m_ks.new_t();
        * m_ks = false;
    }

callInMainThreadHelper::~callInMainThreadHelper ( )

inline

Definition at line 131 of file main_thread_callback.h.

                              {
        shutdown();
    }

Member Function Documentation

template<typename host_t , typename arg_t >

void callInMainThreadHelper::add ( host_t *  host, arg_t const &  arg  )

inline

Definition at line 112 of file main_thread_callback.h.

                                                {
        add_( new service_impl_t< entry<host_t, arg_t> >( host, arg, m_ks ) );
    }

template<typename host_t >

void callInMainThreadHelper::add ( host_t *  host )

inline

Definition at line 116 of file main_thread_callback.h.

                              {
        add_( new service_impl_t< entryVoid<host_t> >( host, m_ks ) );
    }

void callInMainThreadHelper::add_ ( main_thread_callback::ptr  cb )

inline

Definition at line 119 of file main_thread_callback.h.

                                            {
        main_thread_callback_add( cb );
    }

void callInMainThreadHelper::shutdown ( )

inline

Definition at line 127 of file main_thread_callback.h.

                    {
        PFC_ASSERT( core_api::is_main_thread() );
        * m_ks = true;
    }

Field Documentation

killswitch_t callInMainThreadHelper::m_ks

private

Definition at line 136 of file main_thread_callback.h.

---

The documentation for this class was generated from the following file:

• foobar2000/SDK/main_thread_callback.h