std::mutex

class mutex;

Класс mutex — это примитив синхронизации, который может быть использован для защиты общих данных от одновременного доступа нескольких потоков.

mutex обеспечивает семантику исключительной, нерекурсивной владения:

• Вызывающий поток владеет mutex с момента успешного вызова либо lock, либо try_lock до вызова unlock.
• Когда поток владеет mutex, все остальные потоки будут блокироваться (при вызовах lock) или получать значение false (при вызовах try_lock) при попытке получить владение над mutex.
• Вызывающий поток не должен владеть mutex перед вызовом lock или try_lock.

Поведение программы не определено, если mutex уничтожается, пока им всё ещё владеет какой-либо поток, или поток завершается, пока он владеет mutex. Класс mutex удовлетворяет всем требованиям Mutex и StandardLayoutType.

std::mutex не является копируемым и неперемещаемым.

Типы членов

Члены-функции

Примечания

std::mutex обычно не обращается к нему напрямую: std::unique_lock, std::lock_guard, или std::scoped_lock(с C++17) управляют блокировкой более безопасным способом с точки зрения исключений.

Пример

#include <chrono>
#include <iostream>
#include <map>
#include <mutex>
#include <string>
#include <thread>
 
std::map<std::string, std::string> g_pages;
std::mutex g_pages_mutex;
 
void save_page(const std::string& url)
{
    // simulate a long page fetch
    std::this_thread::sleep_for(std::chrono::seconds(2));
    std::string result = "fake content";
 
    std::lock_guard<std::mutex> guard(g_pages_mutex);
    g_pages[url] = result;
}
 
int main() 
{
    std::thread t1(save_page, "http://foo");
    std::thread t2(save_page, "http://bar");
    t1.join();
    t2.join();
 
    // safe to access g_pages without lock now, as the threads are joined
    for (const auto& pair : g_pages)
        std::cout << pair.first << " => " << pair.second << '\n';
}

http://bar => fake content
http://foo => fake content

См. также