std::unique_lock<Mutex>::try_lock
From cppreference.com
< cpp | thread | unique lock
| bool try_lock(); |
(C++11以降) | |
関連するミューテックスをブロックせずにロック(つまり、所有権を取得)しようとします。実質的に mutex()->try_lock() を呼び出します。
関連するミューテックスがない場合、またはミューテックスがこの std::unique_lock によって既にロックされている場合は、std::system_error がスローされます。
目次 |
[編集] パラメータ
(なし)
[編集] 戻り値
true ミューテックスの所有権が正常に取得された場合、false それ以外の場合。
[編集] 例外
- 関連するミューテックスが存在しない場合は、エラーコード std::errc::operation_not_permitted を持つ std::system_error。
- ミューテックスがこの
std::unique_lockによって既にロックされている場合は、std::errc::resource_deadlock_would_occur のエラーコードを持つ std::system_error。
[編集] 例
以下の例は、ロックおよびアンロックされたミューテックスの取得を試みます。
このコードを実行
#include <chrono> #include <iostream> #include <mutex> #include <thread> #include <vector> using namespace std::chrono_literals; int main() { std::mutex counter_mutex; std::vector<std::thread> threads; using Id = int; auto worker_task = [&](Id id, std::chrono::seconds wait, std::chrono::seconds acquire) { // wait for a few seconds before acquiring lock. std::this_thread::sleep_for(wait); std::unique_lock<std::mutex> lock(counter_mutex, std::defer_lock); if (lock.try_lock()) std::cout << '#' << id << ", lock acquired.\n"; else { std::cout << '#' << id << ", failed acquiring lock.\n"; return; } // keep the lock for a while. std::this_thread::sleep_for(acquire); std::cout << '#' << id << ", releasing lock (via destructor).\n"; }; threads.emplace_back(worker_task, Id{0}, 0s, 2s); threads.emplace_back(worker_task, Id{1}, 1s, 0s); threads.emplace_back(worker_task, Id{2}, 3s, 0s); for (auto& thread : threads) thread.join(); }
出力
#0, lock acquired. #1, failed acquiring lock. #0, releasing lock (via destructor). #2, lock acquired. #2, releasing lock (via destructor).
[編集] 関連項目
| 関連付けられたミューテックスをロックします(つまり、所有権を取得します)。 (public member function) | |
| 指定された時間だけミューテックスが利用できない場合に戻る、関連付けられたTimedLockableミューテックスのロック(つまり、所有権の取得)を試みます。 (public member function) | |
| 指定された時間点に達するまでミューテックスが利用できない場合に戻る、関連付けられたTimedLockableミューテックスのロック(つまり、所有権の取得)を試みます。 (public member function) | |
| 関連付けられたミューテックスをアンロックします(つまり、所有権を解放します)。 (public member function) |