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;