# OS_TryLockMutex[R|W]

## 構文

  `#include <nitro/os.h>`
  `BOOL OS_TryLockMutexR( OSMutex* mutex );`
  `BOOL OS_TryLockMutexW( OSMutex* mutex );`

## 引数

mutex | OSMutex 構造体へのポインタ

## 返り値

mutex が正しくロックされた場合は TRUE を、そうでない場合は FALSE を返します。

## 説明

呼び出したスレッドはmutex のロックを試みます。

mutex は変更しようとしている OSMutex 構造体へのポインタです。

`OS_TryLockMutexR()` は read lock を試みます。`OS_TryLockMutexW()` は write lock を試みます。2つのロックの違いは、`OS_LockMutexR()/OS_LockMutexW()` を参照してください。

ロックできない場合は FALSE を返します。ロックできる場合は、`OS_TryLockMutexR()` は `OS_LockMutexR()` の、`OS_TryLockMutexW()` は `OS_LockMutexW()` の処理に準じます。

## 参照

`OS_InitMutex, OS_LockMutex, OS_UnlockMutex
OS_LockMutexR, OS_LockMutexW, OS_UnlocMutexR, OS_UnlocMutexW
OS_LockMutexFromRToW, OS_LockMutexFromWToR
OS_TryLockMutexFromRToW, OS_TryLockMutexFromWToR
`

## 履歴

2008/12/16 初版