LUMIERA.clone/tests/library/thread-wrapper-self-recognition-test.cpp
Ichthyostega 6735857f3b Library: draft a SyncBarrier latch
Intended as replacement for the Mutex/ConditionVar based barrier
built into the exiting Lumiera thread handling framework and used
to ensure safe hand-over of a bound functor into the starting new
thread. The standard requires a comparable guarantee for the C++17
concurrency framework, expressed as a "synchronizes_with" assertion
along the lines of the Atomics framework.

While in most cases dedicated synchronisation is thus not required
anymore when swtiching to C++17, some special extended use cases
remain to be addressed, where the complete initialisation of
further support framework must be ensured.

With C++20 this would be easy to achieve with a std::latch, so we
need a simple workaround for the time being. After consideration of
the typical use case, I am aiming at a middle ground in terms of
performance, by using a yield-wait until satisfying the latch condition.
2023-09-22 21:55:53 +02:00

93 lines
2.4 KiB
C++

/*
ThreadWrapperSelfRecognitionTest(Test) - detect when code is running within a thread
Copyright (C) Lumiera.org
2017, Hermann Vosseler <Ichthyostega@web.de>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 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 General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
* *****************************************************/
/** @file thread-wrapper-self-recognition-test.cpp
** unit test \ref ThreadWrapperSelfRecognitionTest_test
*/
#include "lib/test/run.hpp"
#include "lib/test/test-helper.hpp"
#include "lib/thread.hpp"
#include "lib/error.hpp"
using test::Test;
namespace lib {
namespace test {
namespace {
class TestThread
: Thread
{
public:
TestThread()
: Thread{"test Thread self recognition"
,[&]()
{
CHECK (invocation_happens_within_this_thread());
}}
{ }
bool
invocation_happens_within_this_thread()
{
return invokedWithinThread();
}
};
}
/******************************************************//**
* @test verify the ability of a thread to detect code
* executing within the thread itself.
*
* @see Thread::invokedWithinThread()
* @see steam::control::DispatcherLoop::stateIsSynched()
*/
class ThreadWrapperSelfRecognitionTest_test : public Test
{
virtual void
run (Arg)
{
TestThread testThread;
CHECK (not testThread.invocation_happens_within_this_thread());
usleep(10); // give the thread a chance to run before shutdown
}
};
/** Register this test class... */
LAUNCHER (ThreadWrapperSelfRecognitionTest_test, "function common");
}} // namespace lib::test