Reference: IVEThreadTryAcquireMutex

Overview

Locks a mutual exclusion lock if it is currently unlocked.

Prototype (C)

#include "ive_standards.h"
#include "ive_thread.h"
int IVEThreadTryAcquireMutex(IVEThreadMutex* p_mutex);

Prototype (Fortran)

There is no Fortran interface.

Parameters

p_mutex

p_mutex points to the mutex to be locked.

Return value

If *p_mutex could be locked, the function returns true and the caller should release the lock with IVEThreadReleaseMutex when it no longer needs to hold the mutex. If *p_mutex could not be locked because it was already locked, the function returns false.

Side effects

Inclusion of ive_standards.h sets certain feature-set macros. It is safest to include it before any other headers to avoid inconsistent definitions.

Cross references

IVEThreadInitMutex, IVEThreadDestroyMutex, IVEThreadAcquireMutex, IVEThreadReleaseMutex, and IVEThreadMutex

| categories | alphabetical |

modified June 30, 2001