X Tutup
The Wayback Machine - https://web.archive.org/web/20240917115923/https://ru.cppreference.com/w/cpp/thread/mutex
Пространства имён
Варианты
Действия

std::mutex

Материал из cppreference.com
< cpp‎ | thread
 
C++
Поддержка компилятором
Автономные и размещённые реализации
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Требования к именованию
Макросы тестирования функциональности (C++20)
Поддержка языка
Библиотека концептов (C++20)
Библиотека метапрограммирования (C++11)
Библиотека диагностики
Библиотека общих утилит
Библиотека строк
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека численных данных
Библиотека ввода/вывода
Библиотека локализаций
Регулярные выражения (C++11)
Атомарные операции (C++11)
Библиотека поддержки конкуренции (C++11)
Библиотека файловой системы (C++17)
Технические спецификации
Указатель символов
Внешние библиотеки
 
Библиотека поддержки конкуренции
Ветви
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)(C++17)
Пространство имён this_thread
(C++11)
(C++11)
(C++11)
(C++11)
Атомарные типы
(C++11)
(C++20)
(C++11)
Инициализация атомарных типов
(C++11)(устарело в C++20)
(C++11)(устарело в C++20)
(C++11)(устарело в C++20)
Функции освобождения для атомарных операций
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
Функции освобождения для атомарных флагов
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
Упорядочивание памяти
(C++11)
(C++11)
(C++11)
(C++11)
Взаимное исключение
mutex
(C++11)
(C++11)
(C++17)
Общее управление блокировкой
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Условные переменные
(C++11)
(C++11)
(C++11)
(C++11)
Семафоры
(C++20)(C++20)
Защёлки и барьеры
(C++20)
(C++20)
Фьючерсы
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
 
std::mutex
Функции-элементы
Блокировка
Встроенный дескриптор
 
Определено в заголовочном файле <mutex>
class mutex;
 (начиная с C++11)

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

mutex предлагает эксклюзивную, нерекурсивную семантику владения:

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

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

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

Содержание

[править] Типы-элементы

Тип-элемент Определение
native_handle_type (не всегда присутствует) определяется реализацией[править]

[править] Функции-элементы

 создаёт мьютекс
(public функция-элемент) [править]
уничтожает мьютекс
(public функция-элемент) [править]
operator=
[удалено]
 копирующее присваивание не возможно
(public функция-элемент) [править]
Блокировка
блокирует мьютекс, блокируется, если мьютекс недоступен
(public функция-элемент) [править]
пытается заблокировать мьютекс, возвращается, если мьютекс недоступен
(public функция-элемент) [править]
разблокирует мьютекс
(public функция-элемент) [править]
Встроенный дескриптор
возвращает базовый объект-дескриптор, определяемый реализацией
(public функция-элемент) [править]

[править] Примечание

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

[править] Пример

В этом примере показано, как mutex можно использовать для защиты std::map, совместно используемого двумя потоками.

Запустить этот код
#include <iostream>
#include <map>
#include <string>
#include <chrono>
#include <thread>
#include <mutex>
 
std::map<std::string, std::string> g_pages;
std::mutex g_pages_mutex;
 
void save_page(const std::string &url)
{
    // имитация получение длинной страницы
    std::this_thread::sleep_for(std::chrono::seconds(2));
    std::string result = "случайное содержимое";
 
    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();
 
    // безопасный доступ к g_pages без блокировки, так как потоки объединены
    for (const auto &pair : g_pages) {
        std::cout << pair.first << " => " << pair.second << '\n';
    }
}

Вывод: 

http://bar => случайное содержимое
http://foo => случайное содержимое

[править] Смотрите также

(C++11)
 предоставляет возможность взаимного исключения, которое может быть рекурсивно заблокировано одним и тем же потоком
(класс) [править]
(C++11)
 реализует обёртку владения мьютексом строго в области видимости
(шаблон класса) [править]
(C++11)
 реализует перемещаемую оболочку владения мьютексом
(шаблон класса) [править]
(C++17)
 обёртка RAII для предотвращения взаимоблокировок для нескольких мьютексов
(шаблон класса) [править]
(C++11)
 предоставляет условную переменную, связанную с std::unique_lock
(класс) [править]
Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/thread/mutex&oldid=50870»
X Tutup