Fügt ein Element an den Anfang der Queue an.


icon

Ein-/Ausgänge

  • cqueuern.png Queue —

    Queue ist die Referenz auf eine Queue.

    Mit der Funktion Queue anfordern kann eine Queue-Referenz abgerufen werden.
  • cstr.png Element —

    Element ist das Element, das Sie am Anfang einer Queue einreihen möchten.

    Der Datentyp dieses Parameters passt sich immer automatisch dem des Parameters Queue an.
  • ci32.png Timeout in ms (-1) —

    Timeout (ms) gibt an, wie viele Millisekunden die Funktion bei voller Queue darauf warten soll, dass Platz in der Queue verfügbar wird.

    Die Standardeinstellung lautet –1 (keine Zeitbegrenzung).

    Wenn die Funktion für die Dauer von Timeout (ms) gewartet hat und die Queue noch immer voll ist, wird Timeout? auf TRUE gesetzt.

  • cerrcodeclst.png Fehler (Eingang, kein Fehler) —

    Fehler (Eingang) beschreibt Fehlerbedingungen, die vor der Ausführung des Knotens auftreten. An Fehler (Eingang) werden Standardfehlerdaten übergeben.

  • iqueuern.png Queue (Ausgang) —

    Queue (Ausgang) gibt die Referenz auf die Queue unverändert aus.

  • ibool.png Timeout? —

    Timeout? ist TRUE, wenn vor Ablauf der Zeitbegrenzung kein Platz in der Queue verfügbar wird. Timeout? gibt auch TRUE aus, wenn die Funktion einen Fehler erkennt.

  • ierrcodeclst.png Fehler (Ausgang) —

    Fehler (Ausgang) enthält Angaben zum Fehler. Dieser Ausgang ist ein Standardausgang zur Fehlerausgabe.

    • Diese Funktion ähnelt der Funktion Element einfügen. Ist die Queue voll, wartet die Funktion für die Dauer von Timeout (ms). Wenn Queue den Status "ungültig" annehmen sollte (zum Beispiel nach Freigabe der Queue-Referenz), wird der Wartevorgang beendet und der Fehlercode 1122 ausgegeben.

    Queues behandeln Daten normalerweise nach dem FIFO-Prinzip, das heißt, das Element, das zuerst in die Queue aufgenommen wird, wird auch als erstes verarbeitet. In Ausnahmefällen kann es sein, dass Sie diesen Datenfluss unterbinden möchten, indem Sie ein Element an den Anfang der Queue stellen. Die nächste Funktion des Typs Element aus Queue entfernen, die aufgerufen wird, entfernt dann das Element am Anfang der Queue. Sie können mit dieser Funktion also beispielsweise die Queue als Stack verwenden oder Elemente mit hoher Priorität an den Anfang der Queue stellen.

    Beispiele

    Die folgenden Beispieldateien sind in LabVIEW enthalten.

    • labview\examples\Synchronization\Queue\Queue Stack Maze Solver.vi