Home / Autodocs / exec.library
NAME
- AttemptSemaphoreShared
-
try to obtain without blocking (V37)
SYNOPSIS
success = AttemptSemaphoreShared(signalSemaphore)
D0 A0
LONG AttemptSemaphoreShared(struct SignalSemaphore *);
D0 A0
LONG AttemptSemaphoreShared(struct SignalSemaphore *);
FUNCTION
This call is similar to ObtainSemaphoreShared(), except that it will not block if the semaphore could not be locked.
INPUTS
- signalSemaphore
-
an initialized signal semaphore structure
RESULT
- success
-
TRUE if the semaphore was granted, false if some other Task already possessed the semaphore in exclusive mode.
NOTES
This call does NOT preserve registers.
Starting in Kickstart 3.0 (V39) this call will grant the semaphore if the caller is already the owner of an exclusive lock on the semaphore. In pre-V39 systems this would not be the case. If you need this feature you can do the following workaround:
Starting in Kickstart 3.0 (V39) this call will grant the semaphore if the caller is already the owner of an exclusive lock on the semaphore. In pre-V39 systems this would not be the case. If you need this feature you can do the following workaround:
LONG myAttemptSemaphoreShared(struct SignalSemaphore *ss)
{
}
{
LONG success;
/* Try for a shared semaphore */
success = AttemptSemaphoreShared(ss)
if (success == FALSE)
{
}
return success;
/* Try for a shared semaphore */
success = AttemptSemaphoreShared(ss)
if (success == FALSE)
{
return success;
SEE ALSO
ObtainSemaphore() ObtainSemaphoreShared(), ReleaseSemaphore(), "exec/semaphores.i", <exec/semaphores.h>