pthread_mutex_trylock() - mutex オブジェクトのロックの試行

標準

標準/拡張機能	C/C++	依存項目
POSIX.4a Single UNIX Specification、バージョン 3	両方	POSIX(ON)

形式

#define _OPEN_THREADS
#include <pthread.h>

int pthread_mutex_trylock(pthread_mutex_t *mutex);

SUSV3:

#define _UNIX03_THREADS
#include <pthread.h>

int pthread_mutex_trylock(pthread_mutex_t *mutex);

機能説明

mutex を識別する mutex オブジェクトをロックします。mutex は、共用リソースを保護する場合に使用されます。 pthread_mutex_trylock() はロックされると、即時に戻ります。

再帰的 mutex の場合、pthread_mutex_trylock() は、mutex を解放するためにスレッドが pthread_mutex_trylock() を呼び出す必要がある回数のカウントにこれを効果的に追加します。(つまり、pthread_mutex_lock() と同じ動作をとります。)

戻り値

正常に実行された場合、pthread_mutex_trylock() は 0 を戻します。

正常に実行されなかった場合、pthread_mutex_trylock() は -1 を戻して、errno を次のいずれかの値に設定します。

エラー・コード: 説明
EAGAIN: mutex の再帰的ロックの最大数を超えたため、mutex は取得できませんでした。この errno は共用パスでのみ発生します。
EBUSY: mutex は既にロックされていたので、取得できませんでした。
EINVAL: mutex によって指定された値は無効です。

Single UNIX Specification、バージョン 3 の特殊な動作: 正常に実行されなかった場合、pthread_mutex_trylock() はエラーを示すエラー番号を戻します。

使用上の注意

_OPEN_SYS_MUTEX_EXT フィーチャー・スイッチが設定されている場合、スレッドが終了 (正常終了であっても、異常終了であっても) したときに、すべての共用 (拡張) mutex ロックが解放されます。スレッドが通常に終了した場合 (すなわち、pthread_exit() または pthread_cancel())、mutex ロックの最初の待機者が再開されます。スレッドが異常終了した場合、この mutex ロックの mutex 待機者のプロセスは終了します。

例

CELEBP40

⁄* CELEBP40 *⁄                                   
#define _OPEN_THREADS                                                           
#include <pthread.h>                                                            
#include <stdio.h>                                                              
#include <errno.h>                                                              
                                                                                
pthread_mutex_t mutex;                                                          
                                                                                
void *thread(void *arg) {                                                       
  if (pthread_mutex_trylock(&mutex) != 0)                                       
    if (errno == EBUSY)                                                         
      puts("thread was denied access to the mutex");                            
    else {                                                                      
      perror("pthread_mutex_trylock() error");                                  
      exit(1);                                                                  
    }                                                                           
  else puts("thread was granted the mutex");                                    
}                                                                               
                                                                                
main() {                                                                        
  pthread_t thid;                                                               
                                                                                
  if (pthread_mutex_init(&mutex, NULL) != 0) {                                  
    perror("pthread_mutex_init() error");                                       
    exit(2);                                                                    
  }                                                                             
                                                                                
  if (pthread_create(&thid, NULL, thread, NULL) != 0) {                         
    perror("pthread_create() error");                                           
    exit(3);                                                                    
  }                                                                             
  if (pthread_mutex_trylock(&mutex) != 0)                                       
    if (errno == EBUSY)                                                         
      puts("IPT was denied access to the mutex");                               
    else {                                                                      
      perror("pthread_mutex_trylock() error");                                  
      exit(4);                                                                  
    }                                                                           
  else puts("IPT was granted the mutex");                                       
                                                                                
  if (pthread_join(thid, NULL) != 0) {                                          
    perror("pthread_mutex_trylock() error");                                    
    exit(5);                                                                    
  }                                                                             
}

出力:

IPT was granted the mutex
thread was denied access to the mutex

pthread_mutex_trylock() - mutex オブジェクトのロックの試行

標準

形式

機能説明

戻り値

使用上の注意

例

関連情報