semValue (Function)

The semValue() function will return the current value of the specified semaphore.

Input:

sem : SEMAPHORE

The semaphore to query.                

Returns: INT

Declaration:

FUNCTION semValue : INT;
VAR_INPUT
   sem : SEMAPHORE;
END_VAR;

Example:

INCLUDE rtcu.inc
 
VAR
   sem : SEMAPHORE;
END_VAR;
 
PROGRAM test;
   ...
   // Initialize Semaphore
   sem := semInit(initval:=3);
   IF semValue(sem:=sem) = -1 THEN DebugMsg(message:="sem failed to init!"); END_IF;
   ...
BEGIN
   ...
   // Wait until resource is free or timeout
   IF semWait(sem:=sem,timeout:=1000) = 0 THEN
      // Only do these actions if we have access to the resource
      ...
      // Free the resource after use
      semSignal(sem:=sem);
   END_IF;
   ...
END;
 
END_PROGRAM;