std::shared_lock<Mutex>::try_lock_for
| template< class Rep, class Period > bool try_lock_for( const std::chrono::duration<Rep,Period>& timeout_duration ); |
(seit C++14) | |
Versucht, den zugeordneten Mutex im Shared-Modus zu sperren. Blockiert, bis die angegebene timeout_duration abgelaufen ist oder die Sperre erworben wurde, je nachdem, was zuerst eintritt. Bei erfolgreichem Erwerb der Sperre wird true zurückgegeben, andernfalls wird false zurückgegeben. Ruft effektiv mutex()->try_lock_shared_for(timeout_duration) auf.
Diese Funktion kann aufgrund von Planungs- oder Ressourcenkonfliktverzögerungen länger als timeout_duration blockieren.
Der Standard empfiehlt die Verwendung einer stabilen Uhr zur Messung der Dauer. Wenn eine Implementierung stattdessen eine Systemuhr verwendet, kann die Wartezeit auch empfindlich auf Uhrenanpassungen reagieren.
std::system_error wird ausgelöst, wenn kein zugehöriger Mutex vorhanden ist oder wenn der Mutex bereits gesperrt ist.
Das Verhalten ist undefiniert, wenn Mutex die Anforderungen an SharedTimedLockable nicht erfüllt.
Inhalt |
[edit] Parameter
| timeout_duration | - | maximale Dauer für das Blockieren |
[edit] Rückgabewert
true, wenn der Besitz des Mutex erfolgreich erworben wurde, andernfalls false.
[edit] Ausnahmen
- Alle Ausnahmen, die von mutex()->try_lock_shared_for(timeout_duration) ausgelöst werden.
- Wenn kein zugeordneter Mutex vorhanden ist, std::system_error mit einem Fehlercode von std::errc::operation_not_permitted.
- Wenn der Mutex bereits gesperrt ist, std::system_error mit dem Fehlercode std::errc::resource_deadlock_would_occur.
[edit] Beispiel
| Dieser Abschnitt ist unvollständig Grund: kein Beispiel |
[edit] Siehe auch
| versucht, den zugehörigen TimedLockable Mutex zu sperren (d.h. den Besitz zu übernehmen) und kehrt zurück, wenn der Mutex für die angegebene Zeitspanne nicht verfügbar war (public member function of std::unique_lock<Mutex>) | |
| sperrt den zugehörigen Mutex (public member function) | |
| versucht, den zugehörigen Mutex zu sperren (public member function) | |
| versucht, den zugehörigen Mutex bis zu einem bestimmten Zeitpunkt zu sperren (public member function) | |
| entsperrt den zugehörigen Mutex (public member function) |
