wxMutex

wxMutex

mutex オブジェクトは同期のための機構で，いずれかのスレッドが所有権を持っているときには signaled 状態になる． mutex という名前は，共有リソースへの mutually-exclusive(排他的) アクセスを実現するのに便利なことからつけられた．ただ一つのスレッドが mutex オブジェクトを所有する事ができるが， (あるスレッドが，自分が待機している間はロックが解除されないオブジェクトを待って待機しつづけるという，デッドロック現象が起こる代わりに) 既にロックされたオブジェクトをロックすることができるという意味で，再帰的である．

A mutex object is a synchronization object whose state is set to signaled when it is not owned by any thread, and nonsignaled when it is owned. Its name comes from its usefulness in coordinating mutually-exclusive access to a shared resource. Only one thread at a time can own a mutex object but the mutexes are recursive in the sense that a thread can lock a mutex which it had already locked before (instead of dead locking the entire process in this situation by starting to wait on a mutex which will never be released while the thread is waiting).

例えば，複数のスレッドがリンクリストの中のデータを使う場合，リストの更新は，ある時点では，一つのスレッドしか行ってはならない．なぜなら新しいノードのリストへの追加中は，リストの完全性が一時的に破壊される (これはprogram invariantと呼ばれることもある)からである．

For example, when several thread use the data stored in the linked list, modifications to the list should be only allowed to one thread at a time because during a new node addition the list integrity is temporarily broken (this is also called program invariant).

Example

    
    // この変数は static なので "s_" というプリフィックスをつけている．
    // 一般的に，マルチスレッドプログラムでは，このプリフィックスは mutex
    // (もしくは critical section) を使うべきであるということを表す良いサインになる．
    
    
    // this variable has an "s_" prefix because it is static: seeing an "s_" in
    // a multithreaded program is in general a good sign that you should use a
    // mutex (or a critical section)
    
    static wxMutex *s_mutexProtectingTheGlobalData;

    
    // このグローバルな配列に，複数のスレッドから同時に用いられると推定される
    // 幾つかの数値を格納する．
    
    
    // we store some numbers in this global array which is presumably used by
    // several threads simultaneously
    
    wxArrayInt s_data;

    void MyThread::AddNewNode(int num)
    {
        
        // 他のスレッドがリストにアクセスしないことを確実にする．
        
        
        // ensure that no other thread accesses the list
        
        s_mutexProtectingTheGlobalList->Lock();

        s_data.Add(num);

        s_mutexProtectingTheGlobalList->Unlock();
    }

    
    // 与えられた数値が配列の全ての要素より大きかったらTRUEを返す．
    
    
    // return TRUE the given number is greater than all array elements
    
    bool MyThread::IsGreater(int num)
    {
        
        // リストを使う前に mutex を取得する．
        
        
        // before using the list we must acquire the mutex
        
        wxMutexLocker lock(s_mutexProtectingTheGlobalData);

        size_t count = s_data.Count();
        for ( size_t n = 0; n < count; n++ )
        {
            if ( s_data[n] > num )
                return FALSE;
        }

        return TRUE;
    }

2つ目の関数でどのように wxMutexLocker を使っているかに注意すること．どんな場合でも-戻り値がTRUEでもFALSEでも-確実に mutex がアンロックされる(lockのデストラクタは確実に呼ばれる)． wxMutex を直接使う代わりにこのクラスを使うことは，多くの場合より安全で，もしC++の例外を用いている場合はなおさらそうだ．

Notice how wxMutexLocker was used in the second function to ensure that the mutex is unlocked in any case: whether the function returns TRUE or FALSE (because the destructor of the local object lock is always called). Using this class instead of directly using wxMutex is, in general safer and is even more so if your program uses C++ exceptions.

Derived from

None.

Include files

Members

wxMutex::wxMutex
wxMutex::~wxMutex
wxMutex::Lock
wxMutex::TryLock
wxMutex::Unlock

wxMutex::wxMutex

wxMutex()

デフォルトコンストラクタ

Default constructor.

wxMutex::~wxMutex

~wxMutex()

wxMutex オブジェクトを破棄する．

Destroys the wxMutex object.

wxMutex::Lock

wxMutexError Lock()

mutex オブジェクトをロックする．

Locks the mutex object.

Return value

以下のうちの一つ

One of:

wxMUTEX_NO_ERROR
エラーなし

There was no error.

wxMUTEX_DEAD_LOCK
デッドロックが検出された

A deadlock situation was detected.

wxMUTEX_BUSY
mutex が既に他のスレッドにロックされている．

The mutex is already locked by another thread.

wxMutex::TryLock

wxMutexError TryLock()

mutex オブジェクトのロックを試みる．もしできなければ，すぐにエラーを返す．

Tries to lock the mutex object. If it can't, returns immediately with an error.

Return value

以下のうちの一つ

One of:

wxMutex::Unlock

wxMutexError Unlock()

mutexオブジェクトをアンロックする

Unlocks the mutex object.

Return value

以下の一つ

One of:

wxMUTEX_NO_ERROR
エラーなし

There was no error.

wxMUTEX_DEAD_LOCK
デッドロックが検出された．

A deadlock situation was detected.

wxMUTEX_BUSY
mutex が既に他のスレッドにロックされている．

The mutex is already locked by another thread.

wxMUTEX_UNLOCKED
既にアンロックされている．

The calling thread tries to unlock an unlocked mutex.

wxMUTEX_NO_ERROR	エラーなし There was no error.
wxMUTEX_DEAD_LOCK	デッドロックが検出された A deadlock situation was detected.
wxMUTEX_BUSY	mutex が既に他のスレッドにロックされている． The mutex is already locked by another thread.