Waits for the Set Occurrence function to set the given occurrence.

Note National Instruments encourages you to use the Notifier Operations functions in place of occurrences for most operations.


icon

Inputs/Outputs

  • ci32.png ms timeout (-1) —

    ms timeout is the specified amount of time, in milliseconds, for occurrence to occur.

    If occurrence does not occur within the specified ms timeout, the function returns a value of TRUE. If ms timeout is –1 (default), the function does not time out unless the occurrence wired to this function is invalid. If occurrence is invalid, the function immediately returns TRUE for timed out, even if ms timeout is equal to –1 (default).

  • cocrn.png occurrence —

    occurrence is the occurrence refnum that links Wait on Occurrence and Set Occurrence.

  • cbool.png ignore previous (T) —

    If ignore previous is TRUE (default) and another node has set the occurrence before this function began executing, the function ignores the previous occurrence and waits for another one.

    When ignore previous is FALSE, the function checks whether another node previously set an occurrence. If so, the function executes. However, the Wait on Occurrence function only processes one occurrence at a time and does not hold multiple previous occurrences in memory.

  • ibool.png timed out —

    timed out is TRUE if occurrence does not occur within the specified ms timeout or if occurrence is invalid, even if ms timeout is equal to –1.

    If ms timeout is –1 and occurrence is valid, timed out is FALSE.

    • Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\Synchronization\Occurrence\Simple Occurrence.vi