93 lines
3.1 KiB
C++
93 lines
3.1 KiB
C++
/*
|
|
PIP - Platform Independent Primitives
|
|
Class for simply notify and wait in different threads
|
|
Andrey Bychkov work.a.b@yandex.ru
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include "pithreadnotifier.h"
|
|
|
|
//! \addtogroup Thread
|
|
//! \{
|
|
//! \class PIThreadNotifier pithreadnotifier.h
|
|
//!
|
|
//! \~\brief
|
|
//! \~english Class for simple notify and wait in different threads
|
|
//! \~russian Класс для простого уведомления и ожидания в различных потоках
|
|
//!
|
|
//! \~\details
|
|
//! \~english
|
|
//!
|
|
//! \~russian
|
|
//!
|
|
//!
|
|
//! \~english \section PIThreadNotifier_sec0 Synopsis
|
|
//! \~russian \section PIThreadNotifier_sec0 Краткий обзор
|
|
//! \~english
|
|
//!
|
|
//! \~russian
|
|
//!
|
|
//!
|
|
//! \~english \section PIThreadNotifier_sec1 Usage
|
|
//! \~russian \section PIThreadNotifier_sec1 Использование
|
|
//! \~english
|
|
//!
|
|
//! \~russian
|
|
//!
|
|
//!
|
|
//! \}
|
|
|
|
|
|
PIThreadNotifier::PIThreadNotifier() : cnt(0) {}
|
|
|
|
|
|
//! \~\details
|
|
//! \~english
|
|
//! If \a notifyOnce() has been called before, then returns immediately.\n
|
|
//! If \a notifyOnce() has been called "n" times, then returns immediately "n" times,
|
|
//! but only if wait in one thread.\n
|
|
//! If many threads waiting, then if \a notifyOnce() has been called "n" times,
|
|
//! all threads total returns "n" times in undefined sequence.
|
|
//!
|
|
//! \~russian
|
|
//! Если ранее был вызван \a notifyOnce(), то возвращает управление немедленно.\n
|
|
//! Если ранее был вызван \a notifyOnce() "n" раз, то возвращает управление немедленно "n" раз,
|
|
//! но только если ожидать одним потоком.\n
|
|
//! Если ожидают несколько потоков, и \a notifyOnce() был вызван "n" раз,
|
|
//! то все потоки суммарно вернут управление "n" раз в неопределенной последовательности.
|
|
//!
|
|
void PIThreadNotifier::wait() {
|
|
m.lock();
|
|
while (cnt == 0) v.wait(m);
|
|
cnt--;
|
|
m.unlock();
|
|
}
|
|
|
|
|
|
//! \~\details
|
|
//! \~english
|
|
//! If many threads waiting, then notify randomly one.\n
|
|
//! If call this "n" times, then notify any waiting threads totally "n" times.
|
|
//!
|
|
//! \~russian
|
|
//! Если ожидают несколько потоков, то уведомляет один случайный.\n
|
|
//! Если вызвать "n" раз, то все ожидающие потоки уведомятся суммарно "n" раз.
|
|
void PIThreadNotifier::notifyOnce() {
|
|
m.lock();
|
|
cnt++;
|
|
v.notifyAll();
|
|
m.unlock();
|
|
}
|