# std::unique_lock<Mutex>::try_lock_for

> C++ Atlas: `cppatlas.com/w/cpp/thread/unique_lock/try_lock_for` | Source: https://en.cppreference.com/w/cpp/thread/unique_lock/try_lock_for | Domain: Concurrency support | Standards: C++11

Tries to lock (i.e., takes ownership of) the associated mutex. Blocks until specified timeout_duration has elapsed or the lock is acquired, whichever comes first.

## Official Specification Summary (cppreference)

```cpp
template< class Rep, class Period >
bool try_lock_for( const std::chrono::duration<Rep, Period>& timeout_duration ); // (since C++11)
```

Tries to lock (i.e., takes ownership of) the associated mutex. Blocks until specified `timeout_duration` has elapsed or the lock is acquired, whichever comes first. On successful lock acquisition returns `true`, otherwise returns `false`. Effectively calls `mutex()->try_lock_for(timeout_duration)`.

This function may block for longer than `timeout_duration` due to scheduling or resource contention delays.

The standard recommends that a steady clock is used to measure the duration. If an implementation uses a system clock instead, the wait time may also be sensitive to clock adjustments.

`std::system_error` is thrown if there is no associated mutex or if the mutex is already locked by this std::unique_lock.

### Parameters

- `timeout_duration` - maximum duration to block for

### Return value

`true` if the ownership of the mutex has been acquired successfully, `false` otherwise.

### Exceptions

- Any exceptions thrown by `mutex()->try_lock_for(timeout_duration)`.

- If there is no associated mutex, `std::system_error` with an error code of `std::errc::operation_not_permitted`.

- If the mutex is already locked, `std::system_error` with an error code of `std::errc::resource_deadlock_would_occur`.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`lock`](https://en.cppreference.com/w/cpp/thread/unique_lock/lock): locks (i.e., takes ownership of) the associated mutex (public member function)
- [`try_lock`](https://en.cppreference.com/w/cpp/thread/unique_lock/try_lock): tries to lock (i.e., takes ownership of) the associated mutex without blocking (public member function)
- [`try_lock_for`](https://en.cppreference.com/w/cpp/thread/shared_lock/try_lock_for): tries to lock the associated mutex, for the specified duration (public member function of `std::shared_lock<Mutex>`)
- [`try_lock_until`](https://en.cppreference.com/w/cpp/thread/unique_lock/try_lock_until): tries to lock (i.e., takes ownership of) the associated *TimedLockable* mutex, returns if the mutex has been unavailable until specified time point has been reached (public member function)
- [`unlock`](https://en.cppreference.com/w/cpp/thread/unique_lock/unlock): unlocks (i.e., releases ownership of) the associated mutex (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/thread/unique_lock/try_lock_for (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.