doxygen @ tags replaced to \

This commit is contained in:
2022-03-14 21:19:31 +03:00
parent 9bf1a11701
commit 54b5372356
142 changed files with 1079 additions and 1079 deletions

View File

@@ -1,5 +1,5 @@
/*! @file pithread.h
* @brief Thread
/*! \file pithread.h
* \brief Thread
*
* This file declare thread class and some wait functions
*/
@@ -105,25 +105,25 @@ public:
EVENT_HANDLER1(void, stop, bool, wait);
EVENT_HANDLER0(void, terminate);
//! @brief Set common data passed to external function
//! \brief Set common data passed to external function
void setData(void * d) {data_ = d;}
//! @brief Set external function that will be executed after every \a run()
//! \brief Set external function that will be executed after every \a run()
void setSlot(ThreadFunc func) {ret_func = func;}
//! @brief Set external function that will be executed after every \a run()
//! \brief Set external function that will be executed after every \a run()
void setSlot(std::function<void()> func) {ret_func = [func](void*){func();};}
//! @brief Set priority of thread
//! \brief Set priority of thread
void setPriority(PIThread::Priority prior);
//! @brief Returns common data passed to external function
//! \brief Returns common data passed to external function
void * data() const {return data_;}
//! @brief Return priority of thread
//! \brief Return priority of thread
PIThread::Priority priority() const {return priority_;}
//! @brief Return \c true if thread is running
//! \brief Return \c true if thread is running
bool isRunning() const {return running_;}
bool isStopping() const {return running_ && terminating;}
@@ -133,19 +133,19 @@ public:
EVENT_HANDLER0(bool, waitForFinish) {return waitForFinish(-1);}
EVENT_HANDLER1(bool, waitForFinish, int, timeout_msecs);
//! @brief Set necessity of lock every \a run with internal mutex
//! \brief Set necessity of lock every \a run with internal mutex
void needLockRun(bool need) {lockRun = need;}
//! @brief Lock internal mutex
//! \brief Lock internal mutex
EVENT_HANDLER0(void, lock) const {thread_mutex.lock();}
//! @brief Unlock internal mutex
//! \brief Unlock internal mutex
EVENT_HANDLER0(void, unlock) const {thread_mutex.unlock();}
//! @brief Returns internal mutex
//! \brief Returns internal mutex
PIMutex & mutex() const {return thread_mutex;}
//! @brief Returns thread ID
//! \brief Returns thread ID
llong tid() const {return tid_;}
void __thread_func__();
@@ -154,12 +154,12 @@ public:
EVENT(started)
EVENT(stopped)
//! @brief Start event handler with name \"handler\" of object \"object\"
//! \brief Start event handler with name \"handler\" of object \"object\"
//! in separate thread with name \"name\"
//! and automatically delete it on function finish
static void runOnce(PIObject * object, const char * handler, const PIString & name = PIString());
//! @brief Start function \"func\" in separate thread with name \"name\"
//! \brief Start function \"func\" in separate thread with name \"name\"
//! and automatically delete it on function finish
static void runOnce(std::function<void()> func, const PIString & name = PIString());
@@ -167,7 +167,7 @@ public:
//! \{
/** \fn bool start(int timer_delay = -1)
* @brief Start thread
* \brief Start thread
* \details Start execution of \a run() in internal loop with
* "timer_delay" delay in milliseconds. If "timer_delay" <= 0
* there is no delay in loop. Thread also exec external function
@@ -176,58 +176,58 @@ public:
* \return \c false if thread already started or can`t start thread */
/** \fn bool startOnce()
* @brief Start thread without internal loop
* \brief Start thread without internal loop
* \details Start execution of \a run() once. Thread also exec
* external function set by \a setSlot() if it`s not null
*
* \return \c false if thread already started or can`t start thread */
/** \fn bool startOnce(ThreadFunc func)
* @brief Start thread without internal loop
* \brief Start thread without internal loop
* \details Overloaded function. Set external function "func" before start
*
* \return \c false if thread already started or can`t start thread */
/** \fn void stop(bool wait = false)
* @brief Stop thread
* \brief Stop thread
* \details Stop execution of thread and wait for it finish
* if "wait" is \c true. This function can block for infinite
* time if "wait" is \c true and any of thread function is
* busy forever */
/** \fn void terminate()
* @brief Strongly stop thread
* \brief Strongly stop thread
* \details Stop execution of thread immediately */
/** \fn bool waitForStart(int timeout_msecs = -1)
* @brief Wait for thread start
* \brief Wait for thread start
* \details This function block until thread start for "timeout_msecs"
* or forever if "timeout_msecs" < 0
*
* \return \c false if timeout is exceeded */
/** \fn bool waitForFinish(int timeout_msecs = -1)
* @brief Wait for thread finish
* \brief Wait for thread finish
* \details This function block until thread finish for "timeout_msecs"
* or forever if "timeout_msecs" < 0
*
* \return \c false if timeout is exceeded */
//! \fn void lock()
//! @brief Lock internal mutex
//! \brief Lock internal mutex
//! \fn void unlock()
//! @brief Unlock internal mutex
//! \brief Unlock internal mutex
//! \}
//! \events
//! \{
//! \fn void started()
//! @brief Raise on thread start
//! \brief Raise on thread start
//! \fn void stopped()
//! @brief Raise on thread stop
//! \brief Raise on thread stop
//! \}