PIP 5.6.1
Platform-Independent Primitives
Открытые члены | Защищенные члены | Защищенные данные | Полный список членов класса
Шаблон класса PIPipelineThread< Tin, Tout >abstract

Шаблонный класс потокового конвейера для многоэтапной обработки данных Подробнее...

#include <pipipelinethread.h>

Граф наследования:PIPipelineThread< Tin, Tout >:
Inheritance graph
[см. легенду]

Открытые члены

 PIPipelineThread ()
 Создает конвейерный поток
 
 ~PIPipelineThread ()
 Останавливает поток стадии и может принудительно завершить его, если он не завершится вовремя.
 
template<typename T >
void connectTo (PIPipelineThread< Tout, T > *next)
 Подключает к следующему этапу конвейера через event-уведомления
 
void enqueue (const Tin &v, bool wait=false)
 Добавляет данные в очередь на обработку
 
const ullong * counterPtr () const
 Возвращает указатель на счетчик
 
ullong counter () const
 Возвращает количество обработанных элементов
 
bool isEmpty ()
 Возвращает, пуста ли входная очередь.
 
int queSize ()
 Возвращает текущий размер входной очереди.
 
void clear ()
 Очищает входную очередь
 
void stopCalc (int wait_delay=100)
 Останавливает вычисления и ожидает завершения потока Подробнее...
 
Tout getLast ()
 Возвращает копию последнего успешно вычисленного выхода. Подробнее...
 
uint maxQueSize ()
 Возвращает настроенный предел входной очереди. Подробнее...
 
void setMaxQueSize (uint count)
 Устанавливает предел входной очереди. Подробнее...
 
bool isWaitNextPipe ()
 Возвращает ожидает ли следующий этап конвейера
 
void setWaitNextPipe (bool wait)
 Устанавливает флаг ожидания следующего этапа конвейера Подробнее...
 
- Открытые члены унаследованные от PIThread
 PIThread (void *data, ThreadFunc func, bool startNow=false, PISystemTime loop_delay={})
 Создает поток с пользовательскими данными, обратным вызовом и необязательным немедленным запуском.
 
 PIThread (std::function< void()> func, bool startNow=false, PISystemTime loop_delay={})
 Создает поток с обратным вызовом без пользовательских данных.
 
 PIThread (bool startNow=false, PISystemTime loop_delay={})
 Создает поток для наследования с необязательной задержкой цикла.
 
virtual ~PIThread ()
 Уничтожает объект потока. Если поток еще работает, при уничтожении выполняется принудительное завершение.
 
bool start ()
 Запускает поток с сохраненными обратным вызовом и задержкой цикла.
 
bool start (PISystemTime loop_delay)
 Сохраняет новую задержку цикла и запускает поток.
 
bool start (ThreadFunc func)
 Сохраняет обратный вызов и запускает поток.
 
bool start (ThreadFunc func, PISystemTime loop_delay)
 Сохраняет обратный вызов и задержку цикла, затем запускает поток.
 
bool start (std::function< void()> func)
 Сохраняет лямбда-обратный вызов и запускает поток.
 
bool start (std::function< void()> func, PISystemTime loop_delay)
 Сохраняет лямбда-обратный вызов и задержку цикла, затем запускает поток.
 
bool startOnce ()
 Запускает одноразовый поток без повторяющегося цикла. Подробнее...
 
bool startOnce (ThreadFunc func)
 Сохраняет обратный вызов и запускает одноразовое выполнение. Подробнее...
 
bool startOnce (std::function< void()> func)
 Сохраняет лямбда-обратный вызов и запускает одноразовое выполнение.
 
bool stopAndWait (int timeout_ms) DEPRECATEDM("use stopAndWait(PISystemTime)")
 Устаревшая перегрузка stopAndWait(), принимающая миллисекунды.
 
bool stopAndWait (PISystemTime timeout={})
 Запрашивает остановку и ожидает завершения потока. Возвращает false, если таймаут истек.
 
void setData (void *d)
 Устанавливает указатель данных, передаваемый в обратные вызовы ThreadFunc.
 
void setSlot (ThreadFunc func)
 Устанавливает обратный вызов, выполняемый после каждого прохода run().
 
void setSlot (std::function< void()> func)
 Устанавливает лямбда-обратный вызов, выполняемый после каждого прохода run().
 
void setPriority (PIThread::Priority prior)
 Устанавливает подсказку приоритета. Если поток уже работает, применяет ее немедленно.
 
void * data () const
 Возвращает указатель данных, передаваемый в обратные вызовы ThreadFunc.
 
PIThread::Priority priority () const
 Возвращает настроенную подсказку приоритета.
 
bool isRunning () const
 Возвращает, выполняется ли поток в данный момент.
 
bool isStopping () const
 Возвращает, был ли запрошен останов и поток еще завершает работу.
 
bool waitForStart (PISystemTime timeout={})
 Ожидает запуска потока. Возвращает false, если таймаут истек раньше.
 
bool waitForStart (int timeout_msecs) DEPRECATEDM("use waitForStart(PISystemTime)")
 Устаревшая перегрузка waitForStart(), принимающая миллисекунды. Подробнее...
 
bool waitForFinish (PISystemTime timeout={})
 Ожидает завершения потока. Возвращает false, если таймаут истек раньше.
 
bool waitForFinish (int timeout_msecs) DEPRECATEDM("use waitForFinish(PISystemTime)")
 Устаревшая перегрузка waitForFinish(), принимающая миллисекунды. Подробнее...
 
void needLockRun (bool need)
 Включает блокировку внутреннего мьютекса вокруг begin(), run(), обратных вызовов и end().
 
PIMutexmutex () const
 Возвращает внутренний мьютекс, используемый lock(), unlock() и needLockRun().
 
llong tid () const
 Возвращает системный идентификатор потока, либо -1 когда поток не запущен.
 
void stop ()
 Запрашивает корректное завершение потока. Подробнее...
 
void terminate ()
 Принудительно прерывает поток. Используйте только как крайнюю меру. Подробнее...
 
void lock () const
 Блокирует внутренний мьютекс.
 
void unlock () const
 Разблокирует внутренний мьютекс.
 
void started ()
 Вызывается после запуска потока.
 
void stopped ()
 Вызывается при начале завершения потока.
 
- Открытые члены унаследованные от PIObject
 PIObject (const PIString &name=PIString())
 Создает объект и инициализирует его свойство name.
 
virtual ~PIObject ()
 Уничтожает объект, вызывает deleted() и отключает его от событийного графа.
 
PIString name () const
 Возвращает свойство name этого объекта.
 
virtual const char * className () const
 Возвращает зарегистрированное имя класса этого объекта.
 
virtual uint classNameID () const
 Возвращает хэш от className().
 
virtual const char * parentClassName () const
 Возвращает зарегистрированное имя родительского класса, либо пустую строку для корня.
 
bool debug () const
 Возвращает, включен ли вывод piCoutObj для этого объекта.
 
void setName (const PIString &name)
 Устанавливает свойство name этого объекта.
 
void setDebug (bool debug)
 Включает или отключает вывод piCoutObj для этого объекта.
 
PIVariant property (const char *name) const
 Возвращает свойство объекта по имени "name".
 
void setProperty (const char *name, const PIVariant &value)
 Устанавливает свойство "name" в значение "value" и создаёт его при необходимости. Подробнее...
 
bool isPropertyExists (const char *name) const
 Возвращает, существует ли свойство "name".
 
void setThreadSafe (bool yes)
 Включает или отключает внутренний мьютекс объекта во время выполнения обработчиков. Подробнее...
 
bool isThreadSafe () const
 Возвращает, включен ли внутренний мьютекс объекта для выполнения обработчиков.
 
bool execute (const PIString &method, const PIVector< PIVariantSimple > &vl)
 Выполняет зарегистрированный метод или метод-обработчик по имени с переданными аргументами. Подробнее...
 
bool execute (const PIString &method)
 Перегрузка execute() для метода без аргументов.
 
bool execute (const PIString &method, const PIVariantSimple &v0)
 Перегрузка execute() для одного аргумента.
 
bool execute (const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1)
 Перегрузка execute() для двух аргументов.
 
bool execute (const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1, const PIVariantSimple &v2)
 Перегрузка execute() для трёх аргументов.
 
bool execute (const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1, const PIVariantSimple &v2, const PIVariantSimple &v3)
 Перегрузка execute() для четырёх аргументов.
 
bool executeQueued (PIObject *performer, const PIString &method, const PIVector< PIVariantSimple > &vl)
 Ставит выполнение зарегистрированного метода в очередь объекта-исполнителя. Подробнее...
 
bool executeQueued (PIObject *performer, const PIString &method)
 Перегрузка executeQueued() для метода без аргументов.
 
bool executeQueued (PIObject *performer, const PIString &method, const PIVariantSimple &v0)
 Перегрузка executeQueued() для одного аргумента.
 
bool executeQueued (PIObject *performer, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1)
 Перегрузка executeQueued() для двух аргументов.
 
bool executeQueued (PIObject *performer, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1, const PIVariantSimple &v2)
 Перегрузка executeQueued() для трёх аргументов.
 
bool executeQueued (PIObject *performer, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1, const PIVariantSimple &v2, const PIVariantSimple &v3)
 Перегрузка executeQueued() для четырёх аргументов.
 
void dump (const PIString &line_prefix=PIString()) const
 Выводит диагностическую информацию об объекте в проектный поток вывода.
 
PIStringList scopeList () const
 Возвращает зарегистрированную цепочку наследования объекта, включая его собственный класс.
 
PIStringList methodsEH () const
 Возвращает полные сигнатуры всех зарегистрированных событий и обработчиков для области этого класса.
 
bool isMethodEHContains (const PIString &name) const
 Возвращает, существует ли зарегистрированное событие или обработчик с таким именем.
 
PIString methodEHArguments (const PIString &name) const
 Возвращает список типов аргументов зарегистрированного метода через запятую.
 
PIString methodEHFullFormat (const PIString &name) const
 Возвращает полную зарегистрированную сигнатуру метода.
 
PIString methodEHFromAddr (const void *addr) const
 Возвращает имя зарегистрированного метода для указанного адреса точки входа.
 
void piDisconnect (const PIString &sig, PIObject *dest, void *ev_h)
 Разрывает соединения этого объекта-источника с конкретным обработчиком объекта-приемника для события "sig".
 
void piDisconnect (const PIString &sig, PIObject *dest)
 Разрывает все соединения этого объекта-источника от события "sig" к объекту-приемнику "dest".
 
void piDisconnect (const PIString &sig)
 Разрывает все соединения этого объекта-источника от события "sig".
 
bool isPIObject () const
 Возвращает, указывает ли этот указатель на ещё существующий экземпляр PIObject.
 
template<typename T >
bool isTypeOf () const
 Возвращает, принадлежит ли этот объект классу "T" или одному из его зарегистрированных потомков.
 
template<typename T >
T * cast () const
 Возвращает этот объект, приведённый к типу "T", если isTypeOf<T>() успешно, иначе nullptr.
 
void callQueuedEvents ()
 Выполняет все отложенные доставки, поставленные в очередь этому объекту-исполнителю.
 
bool maybeCallQueuedEvents ()
 Выполняет отложенные доставки только если этот объект использовался как исполнитель. Подробнее...
 
void deleteLater ()
 Планирует отложенное удаление объекта. Подробнее...
 
void deleted (PIObject *o)
 Вызывается непосредственно перед уничтожением объекта. Подробнее...
 

Защищенные члены

virtual Tout calc (Tin &v, bool &ok)=0
 Вычисляет один выход из очередного входного элемента v. Подробнее...
 
- Защищенные члены унаследованные от PIThread
virtual void begin ()
 Виртуальный метод, выполняемый один раз после запуска системного потока и до started().
 
virtual void run ()
 Виртуальный метод, выполняемый на каждой итерации цикла, пока не запрошен останов.
 
virtual void end ()
 Виртуальный метод, выполняемый один раз при завершении потока после stopped().
 
- Защищенные члены унаследованные от PIObject
PIObjectemitter () const
 Возвращает объект-источник, который вызвал текущее событие. Подробнее...
 
virtual void propertyChanged (const char *name)
 Виртуальный метод, вызываемый после изменения свойства "name" через setProperty().
 

Защищенные данные

uint max_size
 Максимальный размер очереди (0 означает без ограничений)
 

Handlers

void enqueue (const Tin &v, bool wait, bool *overload)
 Обработчик события добавления данных в очередь Подробнее...
 

Events

void calculated (const Tout &v, bool wait, bool *overload)
 Генерируется когда результат обработки готов Подробнее...
 

Дополнительные унаследованные члены

- Открытые типы унаследованные от PIThread
enum  Priority {
  piLowerst , piLow , piNormal , piHigh ,
  piHighest
}
 Подсказка приоритета потока. Подробнее...
 
- Открытые статические члены унаследованные от PIThread
static void runOnce (PIObject *object, const char *handler, const PIString &name=PIString())
 Создает временный поток и вызывает в нем обработчик handler объекта object. Подробнее...
 
static void runOnce (std::function< void()> func, const PIString &name=PIString())
 Создает временный поток и выполняет в нем лямбда-выражение func. Подробнее...
 
- Открытые статические члены унаследованные от PIObject
static bool execute (PIObject *o, const PIString &method, const PIVector< PIVariantSimple > &vl)
 Статическая удобная обёртка над execute().
 
static bool execute (PIObject *o, const PIString &method)
 Статическая перегрузка execute() без аргументов.
 
static bool execute (PIObject *o, const PIString &method, const PIVariantSimple &v0)
 Статическая перегрузка execute() для одного аргумента.
 
static bool execute (PIObject *o, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1)
 Статическая перегрузка execute() для двух аргументов.
 
static bool execute (PIObject *o, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1, const PIVariantSimple &v2)
 Статическая перегрузка execute() для трёх аргументов.
 
static bool execute (PIObject *o, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1, const PIVariantSimple &v2, const PIVariantSimple &v3)
 Статическая перегрузка execute() для четырёх аргументов.
 
static bool executeQueued (PIObject *o, PIObject *performer, const PIString &method, const PIVector< PIVariantSimple > &vl)
 Статическая удобная обёртка над executeQueued().
 
static bool executeQueued (PIObject *o, PIObject *performer, const PIString &method)
 Статическая перегрузка executeQueued() без аргументов.
 
static bool executeQueued (PIObject *o, PIObject *performer, const PIString &method, const PIVariantSimple &v0)
 Статическая перегрузка executeQueued() для одного аргумента.
 
static bool executeQueued (PIObject *o, PIObject *performer, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1)
 Статическая перегрузка executeQueued() для двух аргументов.
 
static bool executeQueued (PIObject *o, PIObject *performer, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1, const PIVariantSimple &v2)
 Статическая перегрузка executeQueued() для трёх аргументов.
 
static bool executeQueued (PIObject *o, PIObject *performer, const PIString &method, const PIVariantSimple &v0, const PIVariantSimple &v1, const PIVariantSimple &v2, const PIVariantSimple &v3)
 Статическая перегрузка executeQueued() для четырёх аргументов.
 
static PIObject::Connection piConnect (PIObject *src, const PIString &sig, PIObject *dest_o, void *dest, void *ev_h, void *e_h, int args, const char *loc)
 Низкоуровневый помощник прямого соединения, лежащий под устаревшими макросами CONNECT*.
 
static PIObject::Connection piConnectU (PIObject *src, const PIString &sig, PIObject *dest_o, void *dest, const PIString &hname, const char *loc, PIObject *performer=0)
 Низкоуровневый помощник соединения по имени, лежащий под CONNECTU() и CONNECTU_QUEUED().
 
static PIObject::Connection piConnectLS (PIObject *src, const PIString &sig, std::function< void()> *f, const char *loc)
 Низкоуровневый помощник, который соединяет событие с лямбдой или обёрткой функтора.
 
static void piDisconnect (PIObject *src, const PIString &sig, PIObject *dest, void *ev_h)
 Разрывает соединения объекта-источника "src" с конкретным обработчиком объекта-приемника для события "sig".
 
static void piDisconnect (PIObject *src, const PIString &sig, PIObject *dest)
 Разрывает все соединения объекта-источника "src" от события "sig" к объекту-приемнику "dest".
 
static void piDisconnect (PIObject *src, const PIString &sig)
 Разрывает все соединения объекта-источника "src" от события "sig".
 
static void raiseEvent (PIObject *sender, const uint eventID)
 Внутренний помощник доставки для зарегистрированных событий без аргументов.
 
template<typename T0 >
static void raiseEvent (PIObject *sender, const uint eventID, const T0 &v0=T0())
 Внутренний помощник доставки для зарегистрированных событий с одним аргументом.
 
template<typename T0 , typename T1 >
static void raiseEvent (PIObject *sender, const uint eventID, const T0 &v0=T0(), const T1 &v1=T1())
 Внутренний помощник доставки для зарегистрированных событий с двумя аргументами.
 
template<typename T0 , typename T1 , typename T2 >
static void raiseEvent (PIObject *sender, const uint eventID, const T0 &v0=T0(), const T1 &v1=T1(), const T2 &v2=T2())
 Внутренний помощник доставки для зарегистрированных событий с тремя аргументами.
 
template<typename T0 , typename T1 , typename T2 , typename T3 >
static void raiseEvent (PIObject *sender, const uint eventID, const T0 &v0=T0(), const T1 &v1=T1(), const T2 &v2=T2(), const T3 &v3=T3())
 Внутренний помощник доставки для зарегистрированных событий с четырьмя аргументами.
 
static PIObjectfindByName (const PIString &name)
 Возвращает первый живой объект с именем "name", либо nullptr.
 
static bool isPIObject (const PIObject *o)
 Возвращает, указывает ли "o" на ещё существующий экземпляр PIObject.
 
static bool isPIObject (const void *o)
 Перегрузка isPIObject() для нетипизированного указателя.
 
template<typename T >
static bool isTypeOf (const PIObject *o)
 Возвращает, принадлежит ли "o" классу "T" или одному из его зарегистрированных потомков.
 
template<typename T >
static bool isTypeOf (const void *o)
 Перегрузка isTypeOf() для нетипизированного указателя.
 
static PIString simplifyType (const char *a, bool readable=true)
 Упрощает запись типа C++ для метаданных зарегистрированных методов.
 

Подробное описание

template<typename Tin, typename Tout>
class PIPipelineThread< Tin, Tout >

Шаблонный класс потокового конвейера для многоэтапной обработки данных

Шаблонный класс конвейерного потока для многоэтапной обработки данных в отдельных потоках. Каждый этап обрабатывает входные данные и передает их следующему этапу через event-уведомления.

Методы

◆ enqueue()

template<typename Tin , typename Tout >
void PIPipelineThread< Tin, Tout >::enqueue ( const Tin &  v,
bool  wait,
bool *  overload 
)
inline

Обработчик события добавления данных в очередь

Для ограниченных очередей wait определяет, ждать ли освобождения места или сразу отбросить элемент. Если overload не равен null, он получает значение true, когда элемент отклонен из-за переполнения очереди.

◆ calculated()

template<typename Tin , typename Tout >
void PIPipelineThread< Tin, Tout >::calculated ( const Tout &  v,
bool  wait,
bool *  overload 
)

Генерируется когда результат обработки готов

Вызывается после успешного завершения calc().

Заметки
Флаг wait передается следующей стадии и не влияет на собственную очередь этой стадии.

◆ stopCalc()

template<typename Tin , typename Tout >
void PIPipelineThread< Tin, Tout >::stopCalc ( int  wait_delay = 100)
inline

Останавливает вычисления и ожидает завершения потока

Заметки
Если стадия не остановится за wait_delay, она может быть принудительно завершена.

◆ getLast()

template<typename Tin , typename Tout >
Tout PIPipelineThread< Tin, Tout >::getLast ( )
inline

Возвращает копию последнего успешно вычисленного выхода.

Заметки
Этот снимок хранится отдельно от входной очереди.

◆ maxQueSize()

template<typename Tin , typename Tout >
uint PIPipelineThread< Tin, Tout >::maxQueSize ( )
inline

Возвращает настроенный предел входной очереди.

Заметки
Значение 0 означает, что очередь не ограничена.

◆ setMaxQueSize()

template<typename Tin , typename Tout >
void PIPipelineThread< Tin, Tout >::setMaxQueSize ( uint  count)
inline

Устанавливает предел входной очереди.

Заметки
Значение 0 снимает ограничение. Если очередь уже превышает новый предел, она немедленно приводится к нему.

◆ setWaitNextPipe()

template<typename Tin , typename Tout >
void PIPipelineThread< Tin, Tout >::setWaitNextPipe ( bool  wait)
inline

Устанавливает флаг ожидания следующего этапа конвейера

Устанавливает, должен ли сигнал calculated() запрашивать ожидание на следующей стадии.

Заметки
Этот флаг влияет только на передачу вниз по конвейеру и не меняет правила приема входа этой стадией.

◆ calc()

template<typename Tin , typename Tout >
virtual Tout PIPipelineThread< Tin, Tout >::calc ( Tin &  v,
bool &  ok 
)
protectedpure virtual

Вычисляет один выход из очередного входного элемента v.

Заметки
Оставьте ok равным true, чтобы опубликовать результат, или установите ok в false, чтобы отбросить этот вход без пересылки дальше.