Threads

Evo provides multithreading and synchronization classes that wrap the OS thread APIs (pthreads, win32) and compiler atomics.

These classes provide a common interface on all supported platforms, before and after C++11.

Thread classes:

• Thread, ThreadClass
  • ThreadScope, ThreadScope<Thread>
  • ThreadGroup

Thread safe I/O:

• ConsoleMT, FileMT
• EVO_IO_MT()

Synchronization classes:

• Mutex, MutexRW, Condition
  • MutexInert, SpinLock, SleepLock
• Mutex::Lock
  • MutexRW::LockWrite, MutexRW::LockRead
  • Condition::Lock

Thread-Local Storage:

• EVO_THREAD_LOCAL

Atomic types and Memory fences:

• Atomic, AtomicFlag
  • AtomicInt, AtomicLong, AtomicLongL
  • AtomicUInt, AtomicULong, AtomicULongL
  • AtomicInt32, AtomicInt64
  • AtomicUInt32, AtomicUInt64
• AtomicPtr
• EVO_ATOMIC_FENCE()
  • EVO_ATOMIC_RELAXED, EVO_ATOMIC_CONSUME
  • EVO_ATOMIC_ACQUIRE, EVO_ATOMIC_RELEASE, EVO_ATOMIC_ACQ_REL
  • EVO_ATOMIC_SYNC (default)

Linking:

• Linux/Unix: -pthread
• Cygwin: -lpthread
• Windows: Usually multithreaded by default – MSVC project settings: C/C++ -> Code Generation -> Runtime Library

Note: Before C++ 11, thread safety depends on the compiler. Be especially careful with static and global variables on pre-C++11 compilers. See notes in: C++ Compilers.