Lossy Enqueue Element Function

Adds an element to a queue. If no space is available in the queue, this function removes an element from the front of the queue and discards the element to make space. Unlike the Enqueue Element function, this function does not wait for room in the queue to become available. Use the Obtain Queue function to set the maximum size of the queue.


icon

Inputs/Outputs

  • cqueuern.png queue —

    queue is a reference to a queue. Use the Obtain Queue function to obtain a queue reference.

  • cstr.png element —

    element is the element you want to add to the back of the queue. This data type changes to match the subtype of queue.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • iqueuern.png queue out —

    queue out is a reference to the existing queue.

  • istr.png overflow element —

    overflow element is the element LabVIEW removed from the front of the queue if the queue was full.

  • ibool.png overflow? —

    overflow? returns TRUE if the queue was full and LabVIEW removed an element to create space. overflow? returns FALSE if the queue accepted the element and did not remove an element to make space.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.