cppreference.com

Namespaces

Variants

Actions

std::shared_timed_mutex::lock_shared

From cppreference.com

< cpp‎ | thread‎ | shared timed mutex

Compiler support

Freestanding and hosted

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Diagnostics library

Memory management library

Metaprogramming library (C++11)

General utilities library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Strings library

Text processing library

Numerics library

Date and time library

Input/output library

Filesystem library (C++17)

Concurrency support library (C++11)

Execution control library (C++26)

Technical specifications

External libraries

Concurrency support library

(C++11)

(C++20)

hardware_destructive_interference_sizehardware_constructive_interference_size

(C++17)(C++17)

this_thread namespace

(C++11)

(C++11)

(C++11)

(C++11)

Cooperative cancellation

(C++20)

inplace_stop_token

(C++26)

never_stop_token

(C++26)

(C++20)

inplace_stop_source

(C++26)

(C++20)

inplace_stop_callback

(C++26)

stop_callback_for_t

(C++26)

stoppable_token

(C++26)

unstoppable_token

(C++26)

stoppable-source

(C++26)

stoppable-callback-for

(C++26)

Mutual exclusion

(C++11)

recursive_mutex

(C++11)

(C++17)

(C++11)

recursive_timed_mutex

(C++11)

shared_timed_mutex

(C++14)

Generic lock management

(C++11)

(C++11)

(C++17)

(C++11)

(C++14)

(C++11)

(C++11)

(C++11)

defer_locktry_to_lockadopt_lockdefer_lock_ttry_to_lock_tadopt_lock_t

(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)

Condition variables

condition_variable

(C++11)

condition_variable_any

(C++11)

notify_all_at_thread_exit

(C++11)

(C++11)

counting_semaphorebinary_semaphore

(C++20)(C++20)

Latches and Barriers

(C++20)

(C++20)

(C++11)

(C++11)

(C++11)

(C++11)

(C++11)

(C++11)

(C++11)

(C++11)

future_category

(C++11)

(C++11)

Safe reclamation

(C++26)

(C++26)

rcu_default_domain

(C++26)

rcu_synchronize

(C++26)

(C++26)

(C++26)

Hazard pointers

hazard_pointer_obj_base

(C++26)

(C++26)

make_hazard_pointer

(C++26)

(C++11)

(C++20)

(C++11)

Initialization of atomic types

(C++11)(deprecated in C++20)

ATOMIC_VAR_INIT

(C++11)(deprecated in C++20)

ATOMIC_FLAG_INIT

(C++11)

Memory ordering

(C++11)

kill_dependency

(C++11)(deprecated in C++26)

atomic_thread_fence

(C++11)

atomic_signal_fence

(C++11)

Free functions for atomic operations

atomic_storeatomic_store_explicit

(C++11)(C++11)

atomic_loadatomic_load_explicit

(C++11)(C++11)

atomic_exchangeatomic_exchange_explicit

(C++11)(C++11)

atomic_compare_exchange_weakatomic_compare_exchange_weak_explicitatomic_compare_exchange_strongatomic_compare_exchange_strong_explicit

(C++11)(C++11)(C++11)(C++11)

atomic_fetch_addatomic_fetch_add_explicit

(C++11)(C++11)

atomic_fetch_subatomic_fetch_sub_explicit

(C++11)(C++11)

atomic_fetch_andatomic_fetch_and_explicit

(C++11)(C++11)

atomic_fetch_oratomic_fetch_or_explicit

(C++11)(C++11)

atomic_fetch_xoratomic_fetch_xor_explicit

(C++11)(C++11)

atomic_fetch_maxatomic_fetch_max_explicit

(C++26)(C++26)

atomic_fetch_minatomic_fetch_min_explicit

(C++26)(C++26)

atomic_is_lock_free

(C++11)

atomic_waitatomic_wait_explicit

(C++20)(C++20)

atomic_notify_one

(C++20)

atomic_notify_all

(C++20)

Free functions for atomic flags

atomic_flag_test_and_setatomic_flag_test_and_set_explicit

(C++11)(C++11)

atomic_flag_clearatomic_flag_clear_explicit

(C++11)(C++11)

atomic_flag_testatomic_flag_test_explicit

(C++20)(C++20)

atomic_flag_waitatomic_flag_wait_explicit

(C++20)(C++20)

atomic_flag_notify_one

(C++20)

atomic_flag_notify_all

(C++20)

std::shared_timed_mutex

Member functions

shared_timed_mutex::shared_timed_mutex

shared_timed_mutex::~shared_timed_mutex

Exclusive locking

shared_timed_mutex::lock

shared_timed_mutex::try_lock

shared_timed_mutex::try_lock_for

shared_timed_mutex::try_lock_until

shared_timed_mutex::unlock

Shared locking

shared_timed_mutex::lock_shared

shared_timed_mutex::try_lock_shared

shared_timed_mutex::try_lock_shared_for

shared_timed_mutex::try_lock_shared_until

shared_timed_mutex::unlock_shared

void lock_shared();

(since C++14)

Acquires shared ownership of the mutex. If another thread is holding the mutex in exclusive ownership, a call to lock_shared will block execution until shared ownership can be acquired.

If lock_shared is called by a thread that already owns the mutex in any mode (exclusive or shared), the behavior is undefined.

If more than the implementation-defined maximum number of shared owners already locked the mutex in shared mode, lock_shared blocks execution until the number of shared owners is reduced. The maximum number of owners is guaranteed to be at least 10000.

Prior unlock() operation on the same mutex synchronizes-with (as defined in std::memory_order ) this operation.

Contents

[edit] Parameters

(none)

[edit] Return value

(none)

[edit] Exceptions

Throws std::system_error when errors occur, including errors from the underlying operating system that would prevent lock from meeting its specifications. The mutex is not locked in the case of any exception being thrown.

[edit] Notes

lock_shared() is usually not called directly: std::shared_lock is used to manage shared locking.

[edit] Example

This section is incomplete
Reason: no example

[edit] See also

locks the mutex, blocks if the mutex is not available
(public member function) [edit]

try_lock_shared

tries to lock the mutex for shared ownership, returns if the mutex is not available
(public member function) [edit]

unlocks the mutex (shared ownership)
(public member function) [edit]

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/thread/shared_timed_mutex/lock_shared&oldid=161239"

Todo no example