8.9. mutex — Mutual exclusion support — Python v2.7.2 documentation

### Navigation

- index
- modules |
- next |
- previous |
- Python v2.7.2 documentation »
- The Python Standard Library »
- 8. Data Types »

# 8.9. `mutex` — Mutual exclusion support

Deprecated since version 2.6: The `mutex` module has been removed in Python 3.0.

The `mutex` module defines a class that allows mutual-exclusion via acquiring and releasing locks. It does not require (or imply) `threading` or multi-tasking, though it could be useful for those purposes.

The `mutex` module defines the following class:

class `mutex.` `mutex`

  Create a new (unlocked) mutex.

  A mutex has two pieces of state — a “locked” bit and a queue. When the mutex is not locked, the queue is empty. Otherwise, the queue contains zero or more `(function, argument)` pairs representing functions (or methods) waiting to acquire the lock. When the mutex is unlocked while the queue is not empty, the first queue entry is removed and its `function(argument)` pair called, implying it now has the lock.

  Of course, no multi-threading is implied – hence the funny interface for `lock()`, where a function is called once the lock is acquired.

## 8.9.1. Mutex Objects

`mutex` objects have following methods:

`mutex.` `test`()
  Check whether the mutex is locked.

`mutex.` `testandset`()
  “Atomic” test-and-set, grab the lock if it is not set, and return `True`, otherwise, return `False`.

`mutex.` `lock`(function, argument)
  Execute `function(argument)`, unless the mutex is locked. In the case it is locked, place the function and argument on the queue. See `unlock()` for explanation of when `function(argument)` is executed in that case.

`mutex.` `unlock`()
  Unlock the mutex if queue is empty, otherwise execute the first element in the queue.

### Navigation

- index
- modules |
- next |
- previous |
- Python v2.7.2 documentation »
- The Python Standard Library »
- 8. Data Types »