Programming Reference:OSMutex Class - Revision history

Mellinger: /* See also */

2023-04-18T15:15:19Z

Mellinger: Replaced content with "`OSMutex` is obsolete. Use `std::mutex` instead. ==See also== Programming Reference:OSThread Class, Programming Reference:OSEvent Class Category:..."

2022-06-08T16:17:40Z

Replaced content with "<tt>OSMutex</tt> is obsolete. Use <tt>std::mutex</tt> instead. ==See also== Programming Reference:OSThread Class, Programming Reference:OSEvent Class Category:..."

← Older revision		Revision as of 16:17, 8 June 2022
Line 1:		Line 1:
	~~==Location==~~		<tt>OSMutex</tt> is obsolete. Use <tt>std::mutex</tt> instead.
	~~<tt>BCI2000/src/shared/utils</tt>~~

	~~==Synopsis==~~
	~~The~~ <tt>OSMutex</tt> ~~class provides a wrapper for OS-dependent synchronization functionality, corresponding to a Windows or POSIX threads mutex object.~~

	~~==Methods==~~
	~~===OSMutex()===~~
	~~Mutexes are created in released state, i.e. no thread owns the newly created mutex.~~
	~~===~OSMutex()===~~
	~~Releases all resources allocated for the mutex object.~~
	~~===bool Acquire()===~~
	~~Acquires ownership of the mutex for the current thread. When the mutex is owned by a different thread, the current thread~~ is ~~blocked until the owning thread calls <tt>Release()</tt> on the mutex object~~. When the mutex is already owned by the thread calling <tt>Acquire()</tt>, it does not block; rather, a lock count is increased, and the calling thread continues running. For each call to <tt>Acquire()</tt>, there must be a balancing call to <tt>~~Release()</tt> in order to make the mutex available to other threads. <tt>Acquire</tt> returns true when successful, and false otherwise.~~
	~~===bool Release()===~~
	Gives up ownership of the mutex for the current thread, or decreases the lock count when the mutex has been acquired multiple times by a thread. When multiple threads are waiting for the mutex, a random thread is unblocked. Returns true when successful, and false when an error occurred.

	~~==Sub-classes==~~
	~~===OSMutex::Lock(OSMutex)===~~
	~~An object that acquires the specified mutex when created, and releases it when destructed.~~
	~~===OSMutex~~::~~Unlock(OSMutex)===~~
	~~An object that releases the specified~~ mutex ~~when created, and acquires it when destructed.~~

	~~Use objects of type <tt>OSMutex::Lock</tt> and <tt>OSMutex::Unlock~~</tt> to make sure the mutex is restored to its previous state when the current scope is left. This is especially useful when it is possible that an exception is thrown while the mutex is in its altered state. During stack unwinding, the lock/unlock object's destructor is called, and the mutex is restored to its previous state, even when an exception is thrown.

	==See also==		==See also==

Mellinger at 15:20, 2 May 2011

2011-05-02T15:20:06Z

New page

==Location==
<tt>BCI2000/src/shared/utils</tt>

==Synopsis==
The <tt>OSMutex</tt> class provides a wrapper for OS-dependent synchronization functionality, corresponding to a Windows or POSIX threads mutex object.

==Methods==
===OSMutex()===
Mutexes are created in released state, i.e. no thread owns the newly created mutex.
===~OSMutex()===
Releases all resources allocated for the mutex object.
===bool Acquire()===
Acquires ownership of the mutex for the current thread. When the mutex is owned by a different thread, the current thread is blocked until the owning thread calls <tt>Release()</tt> on the mutex object. When the mutex is already owned by the thread calling <tt>Acquire()</tt>, it does not block; rather, a lock count is increased, and the calling thread continues running. For each call to <tt>Acquire()</tt>, there must be a balancing call to <tt>Release()</tt> in order to make the mutex available to other threads. <tt>Acquire</tt> returns true when successful, and false otherwise.
===bool Release()===
Gives up ownership of the mutex for the current thread, or decreases the lock count when the mutex has been acquired multiple times by a thread. When multiple threads are waiting for the mutex, a random thread is unblocked. Returns true when successful, and false when an error occurred.

==Sub-classes==
===OSMutex::Lock(OSMutex)===
An object that acquires the specified mutex when created, and releases it when destructed.
===OSMutex::Unlock(OSMutex)===
An object that releases the specified mutex when created, and acquires it when destructed.

Use objects of type <tt>OSMutex::Lock</tt> and <tt>OSMutex::Unlock</tt> to make sure the mutex is restored to its previous state when the current scope is left. This is especially useful when it is possible that an exception is thrown while the mutex is in its altered state. During stack unwinding, the lock/unlock object's destructor is called, and the mutex is restored to its previous state, even when an exception is thrown.

==See also==
[[Programming Reference:OSThread Class]], [[Programming Reference:OSEvent Class]]

[[Category:Framework API]][[Category:Development]]

← Older revision		Revision as of 15:15, 18 April 2023
Line 2:		Line 2:

	==See also==		==See also==
	[[Programming Reference:~~OSThread~~ Class]], [[Programming Reference:~~OSEvent~~ Class]]		[[Programming Reference:Thread Class]], [[Programming Reference:WaitableEvent Class]]

	[[Category:Framework API]][[Category:Development]]		[[Category:Framework API]][[Category:Development]]

Programming Reference:OSMutex Class - Revision history

Mellinger: /* See also */

Mellinger: Replaced content with "OSMutex is obsolete. Use std::mutex instead. ==See also== Programming Reference:OSThread Class, Programming Reference:OSEvent Class Category:..."

Mellinger at 15:20, 2 May 2011

Mellinger: Replaced content with "`OSMutex` is obsolete. Use `std::mutex` instead. ==See also== Programming Reference:OSThread Class, Programming Reference:OSEvent Class Category:..."