std::lock_guard or std::scoped_lock?
The scoped_lock
is a strictly superior version of lock_guard
that locks an arbitrary number of mutexes all at once (using the same deadlock-avoidance algorithm as std::lock
). In new code, you should only ever use scoped_lock
.
The only reason lock_guard
still exists is for compatibility. It could not just be deleted, because it is used in current code. Moreover, it proved undesirable to change its definition (from unary to variadic), because that is also an observable, and hence breaking, change (but for somewhat technical reasons).
The single and important difference is that std::scoped_lock
has a variadic constructor taking more than one mutex. This allows to lock multiple mutexes in a deadlock avoiding way as if std::lock
were used.
{
// safely locked as if using std::lock
std::scoped_lock<std::mutex, std::mutex> lock(mutex1, mutex2);
}
Previously you had to do a little dance to lock multiple mutexes in a safe way using std::lock
as explained this answer.
The addition of scope lock makes this easier to use and avoids the related errors. You can consider std::lock_guard
deprecated. The single argument case of std::scoped_lock
can be implemented as a specialization and such you don't have to fear about possible performance issues.
GCC 7 already has support for std::scoped_lock
which can be seen here.
For more information you might want to read the standard paper
Late answer, and mostly in response to:
You can consider
std::lock_guard
deprecated.
For the common case that one needs to lock exactly one mutex, std::lock_guard
has an API that is a little safer to use than scoped_lock
.
For example:
{
std::scoped_lock lock; // protect this block
...
}
The above snippet is likely an accidental run-time error because it compiles and then does absolutely nothing. The coder probably meant:
{
std::scoped_lock lock{mut}; // protect this block
...
}
Now it locks/unlocks mut
.
If lock_guard
was used in the two examples above instead, the first example is a compile-time error instead of a run-time error, and the second example has identical functionality as the version which uses scoped_lock
.
So my advice is to use the simplest tool for the job:
lock_guard
if you need to lock exactly 1 mutex for an entire scope.scoped_lock
if you need to lock a number of mutexes that is not exactly 1.unique_lock
if you need to unlock within the scope of the block (which includes use with acondition_variable
).
This advice does not imply that scoped_lock
should be redesigned to not accept 0 mutexes. There exist valid use cases where it is desirable for scoped_lock
to accept variadic template parameter packs which may be empty. And the empty case should not lock anything.
And that's why lock_guard
isn't deprecated. scoped_lock
and unique_lock
may be a superset of functionality of lock_guard
, but that fact is a double-edged sword. Sometimes it is just as important what a type won't do (default construct in this case).