std::sync::mutex - 排他制御

pthreadベースのMutex（排他ロック）とRwLock（読み書きロック）を提供します。

対応バックエンド: Native (LLVM) のみ

最終更新: 2026-02-08

Mutex

基本的な使い方

import std::sync::mutex::mutex_init;
import std::sync::mutex::mutex_lock;
import std::sync::mutex::mutex_unlock;
import std::sync::mutex::mutex_destroy;

int main() {
    // 64バイトのバッファにMutexを確保
    tiny mtx[64];
    mutex_init(mtx as void*);

    // クリティカルセクション
    mutex_lock(mtx as void*);
    // ... 共有リソースへのアクセス ...
    mutex_unlock(mtx as void*);

    mutex_destroy(mtx as void*);
    return 0;
}

trylock（ノンブロッキング）

int result = mutex_trylock(mtx as void*);
if (result == 0) {
    // ロック取得成功
    mutex_unlock(mtx as void*);
} else {
    // 他のスレッドがロック中
}

API一覧

RwLock（読み書きロック）

複数スレッドからの同時読み取りを許可し、書き込み時のみ排他制御を行います。

基本的な使い方

import std::sync::mutex::rwlock_init;
import std::sync::mutex::rwlock_rdlock;
import std::sync::mutex::rwlock_wrlock;
import std::sync::mutex::rwlock_unlock;
import std::sync::mutex::rwlock_destroy;

int main() {
    tiny lock[64];
    rwlock_init(lock as void*);

    // 読み取りロック（複数スレッドから同時取得可能）
    rwlock_rdlock(lock as void*);
    // ... 読み取り ...
    rwlock_unlock(lock as void*);

    // 書き込みロック（排他）
    rwlock_wrlock(lock as void*);
    // ... 書き込み ...
    rwlock_unlock(lock as void*);

    rwlock_destroy(lock as void*);
    return 0;
}

API一覧

注意事項

• Mutexの確保に tiny mtx[64] のようにスタック上のバイト配列を使用します
• mutex_lock / rwlock_rdlock はブロッキング呼び出しです
• デッドロックに注意：複数のMutexを取得する場合は常に同じ順序で取得してください

関連: スレッド · Channel · Atomic