就业培训     下载中心     Wiki     联络 登录   注册

---

ScopedLock

A maxon::ScopedLock acquires a lock when created and releases upon destruction (at the end of the scope).

警告

ScopedLock should only be used for a short block of code. It will block all other threads.

// lock on creation maxon::ScopedLock scopedLock(lock);

// handle shared resource return UpdateGlobalData(); }

RWSpinlock

The maxon::RWSpinlock allows access for multiple readers and only one exclusive writer.

• maxon::RWSpinlock::WriteLock() : Write lock.
• maxon::RWSpinlock::WriteUnlock() : Write unlock.
• maxon::RWSpinlock::AttemptWriteLock() : Returns true if it could write lock.
• maxon::RWSpinlock::IsWriteLocked() : Returns true if the spin lock is write locked.
• maxon::RWSpinlock::ReadLock() : Read lock.
• maxon::RWSpinlock::ReadUnlock() : Read unlock.
• maxon::RWSpinlock::IsReadLocked() : Returns true if the spin lock is read locked.

// example global instance; typically a member variable would be used static maxon::RWSpinlock g_rwSpinlock; static maxon::Result<void> UpdateWithRWLock() { // write lock g_rwSpinlock. WriteLock ();

// handle shared resource const maxon::Result<void> res = UpdateGlobalData();

// write unlock g_rwSpinlock. WriteUnlock (); return res; } static maxon::Int ReadWithRWLock( maxon::Int i) { // read lock g_rwSpinlock. ReadLock ();

// access shared resource const maxon::Int res = AccessData(i);

// read unlock g_rwSpinlock. ReadUnlock (); return res; }

ARWLock

The maxon::ARWLock is an asymmetric read write lock which prefers the readers.

• maxon::ARWLock::ReadLock() : Read lock.
• maxon::ARWLock::ReadUnlock() : Read unlock.
• maxon::ARWLock::WriteLock() : Write lock.
• maxon::ARWLock::WriteUnlock() : Write unlock.
• maxon::ARWLock::AttemptWriteLock() : Returns true if it could write lock.

// example global instance; typically a member variable would be used static maxon::ARWLock * g_arwlock = nullptr ; static maxon::Result<void> Init() { iferr_scope ; g_arwlock = NewObj ( maxon::ARWLock ) iferr_return ; return maxon::OK ; } static void Clear() { DeleteObj (g_arwlock); } MAXON_INITIALIZATION (Init, Clear); static maxon::Result<void> UpdateWithARWLock() { g_arwlock-> WriteLock (); const maxon::Result<void> res = UpdateGlobalData(); g_arwlock-> WriteUnlock (); return res; }

Synchronized

The maxon::Synchronized template is used to guarantee safe access to a given variable. It allows access to the variable only after a lock has been acquired. For asymmetric read-write access there is also maxon::RWSynchronized based on maxon::ARWLock .

• maxon::SynchronizedValue::Read() : Provides read access to the contained variable.
• maxon::SynchronizedValue::Write() : Provides write access to the contained variable.

// get locked pointer to get write access auto lockedPtr = _string.Write(); for ( maxon::String & str : strings) { lockedPtr->Append(str) iferr_return ; }

// lock on _string is released when the function scope is left return maxon::OK ; } private : maxon::Synchronized<maxon::String> _string; };

Serializer

The maxon::Serializer guarantees mutually exclusive access to a shared resource. The given lambdas are enqueued and executed.

• maxon::Serializer::EnqueueAndWait() : Enqueues a lambda or object with function operator () and waits until it has finished.
• maxon::Serializer::Enqueue() : Enqueues a lambda or object with function operator ().

注意

maxon::Serializer is low level and does not support error handling.

延伸阅读

• 线程
• MAXON API 线程
• 线程手册
• Condition Variables Manual