std::unique_lock<Mutex>::try_lock_for
| template< class Rep, class Period > bool try_lock_for( const std::chrono::duration<Rep, Period>& timeout_duration ); |
(seit C++11) | |
Versucht, die zugehörige Mutex zu sperren (d.h. den Besitz zu übernehmen). 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 false. Ruft effektiv mutex()->try_lock_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 keine zugehörige Mutex vorhanden ist oder wenn die Mutex bereits von diesem std::unique_lock gesperrt ist.
Inhalt |
[bearbeiten] Parameter
| timeout_duration | - | maximale Dauer für das Blockieren |
[bearbeiten] Rückgabewert
true, wenn der Besitz des Mutex erfolgreich erworben wurde, andernfalls false.
[bearbeiten] Ausnahmen
- Alle Ausnahmen, die von mutex()->try_lock_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.
[bearbeiten] Beispiel
| Dieser Abschnitt ist unvollständig Grund: kein Beispiel |
[bearbeiten] Siehe auch
| sperrt den zugehörigen Mutex (d.h. übernimmt den Besitz) (public member function) | |
| versucht, den zugehörigen Mutex ohne Blockieren zu sperren (d.h. den Besitz zu übernehmen) (public member function) | |
| versucht, den zugehörigen Mutex für die angegebene Dauer zu sperren (öffentliche Member-Funktion von std::shared_lock<Mutex>) | |
| versucht, den zugehörigen TimedLockable Mutex zu sperren (d.h. den Besitz zu übernehmen) und kehrt zurück, wenn der Mutex bis zum Erreichen des angegebenen Zeitpunkts nicht verfügbar war (public member function) | |
| entsperrt den zugehörigen Mutex (d.h. gibt den Besitz frei) (public member function) |
