Ajoute un élément au début d'une file d'attente.


icon

Entrées/Sorties

  • cqueuern.png file d'attente —

    file d'attente est une référence à une file d'attente.

    Utilisez la fonction Obtenir une file d'attente pour obtenir une référence à une file d'attente.
  • cstr.png élément —

    élément est l'élément que vous souhaitez ajouter au début de la file d'attente.

    Ce type de données change pour correspondre au sous-type de la file d'attente.
  • ci32.png timeout en ms (-1) —

    timeout en ms spécifie combien de temps, en millisecondes, la fonction attend qu'une place se libère dans la file d'attente si cette dernière est pleine.

    La valeur par défaut est –1, indiquant que la fonction ne donne jamais lieu à un timeout.

    Si le temps d'attente de la fonction dépasse le timeout en ms et que la file d'attente reste pleine, hors délai ? est VRAI.

  • cerrcodeclst.png entrée d'erreur (pas d'erreur) —

    entrée d'erreur décrit les conditions d'erreur qui ont lieu avant l'exécution de ce nœud. Cette entrée fournit la fonctionnalité entrée d'erreur standard.

  • iqueuern.png file d'attente en sortie —

    file d'attente en sortie renvoie la référence à la file d'attente sans modification.

  • ibool.png hors délai ? —

    hors délai ? Renvoie VRAI si aucune place ne s'est libérée dans la file d'attente avant que la fonction ne donne lieu à un timeout. hors délai ? renvoie VRAI si une erreur s'est produite.

  • ierrcodeclst.png sortie d'erreur —

    sortie d'erreur contient des informations sur l'erreur. Cette sortie fournit la fonctionnalité sortie d'erreur standard.

    • Cette fonction est semblable à la fonction Ajouter un élément à la fin d'une file d'attente. Si la file d'attente est pleine, la fonction attend pendant une durée égale au timeout en ms avant de continuer. Si file d'attente devient non valide (par exemple, si la référence à la file d'attente est libérée), la fonction cesse d'attendre et renvoie le code d'erreur 1122.

    Les files d'attente utilisent typiquement un flux de données de type premier entré-premier sorti (first-in-first-out). Dans quelques rares cas, vous pourriez vouloir interrompre ce flux de données en ajoutant un élément au début de la file d'attente. Une fois que vous avez ajouté un élément au début de la file d'attente, la prochaine fonction Supprimer le premier élément d'une file d'attente que vous appellerez supprimera l'élément que vous avez ajouté au début de la file. Vous pourriez par exemple utiliser cette fonction si vous voulez utiliser la file d'attente comme une structure pile ou ajouter des éléments à haute priorité au début de la file d'attente.

    Exemples

    Reportez-vous aux exemples de fichiers inclus avec LabVIEW suivants.

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