Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the develop branch, built from commit 2ef9bb34b9.
PrevUpHome

Yield Primitives

Header <boost/core/yield_primitives.hpp>

Authors

  • Peter Dimov

The header <boost/core/yield_primitives.hpp> implements a collection of primitives that allow the current thread to yield the CPU in various ways.

Very low level, specialized functionality, generally only useful for implementing spinlocks. Normal synchronization primitives should almost always be preferable in application code.

namespace boost
{
namespace core
{

void sp_thread_pause() noexcept;
void sp_thread_yield() noexcept;
void sp_thread_sleep() noexcept;

} // namespace core
} // namespace boost

void sp_thread_pause() noexcept;

Emits a PAUSE instruction (on x86) or a YIELD instruction (on ARM).

A portable equivalent of the GCC builtin function __builtin_ia32_pause.

void sp_thread_yield() noexcept;

Informs the scheduler that the current thread wishes to relinquish the rest of its timeslice.

A portable equivalent of POSIX sched_yield.

void sp_thread_sleep() noexcept;

Sleeps for a short period, as if by calling POSIX nanosleep with a small, implementation-dependent, interval (usually one microsecond).

A more forcing yield primitive than sp_thread_yield, because it's generally not ignored even if all other waiting threads are of lower priority.


PrevUpHome