Utilisez ce nœud de bordure pour accéder à une valeur dans un tableau associatif et la modifier sans la copier en dehors du tableau associatif. Utilisez le nœud de bordure sur le côté gauche de la structure pour récupérer une valeur dans un tableau associatif. Utilisez le nœud de bordure sur le côté droit de la structure pour modifier ou ignorer la valeur récupérée.

Pour placer ce nœud de bordure sur la structure Élément en place, cliquez avec le bouton droit sur le bord d'une structure Élément en place et sélectionnez l'option Ajouter Obtenir / Remplacer une valeur d'un tableau associatif dans le menu local. Vous pouvez également utiliser le VI Accès au tableau associatif en place, qui place une structure Élément en place sur le diagramme avec ce nœud de bordure déjà ajouté.


icon

Entrées/Sorties

  • cmap.png tableau associatif —

    tableau associatif spécifie le tableau associatif dans lequel vous souhaitez rechercher une clé. Cette entrée accepte un tableau associatif de n'importe quel type de données. Le type de données par défaut est un tableau associatif d'entiers signés 32 bits.

  • cstr.png clé —

    clé indique la clé à rechercher dans le tableau associatif. La clé doit être du même type de données que les clés existantes dans le tableau associatif.

  • ci32.png valeur par défaut —

    valeur par défaut spécifie la valeur à renvoyer en valeur si la clé spécifiée n'existe pas dans le tableau associatif. Cette entrée doit être du même type de données que les valeurs existantes dans le tableau associatif.

  • ibool.png clé introuvable ? —

    clé introuvable ? renvoie VRAI si le tableau associatif n'inclut pas d'entrée avec la clé spécifiée. Sinon, clé introuvable ? renvoie FAUX.

    Cette sortie existe sur les nœuds de bordure gauche et droit. Les deux sorties clé introuvable ? renvoient la même valeur.

  • ii32.png valeur —

    valeur renvoie la valeur de l'entrée avec la clé associée si clé introuvable ? est FAUX. Si clé introuvable ? est VRAI, cette sortie renvoie la valeur de valeur par défaut.

  • cenum.png action —

    action spécifie l'opération à effectuer sur le tableau associatif suivant si clé introuvable ? a la valeur VRAI ou FAUX. Cette entrée prend la valeur 0 si non câblée.

    2Delete Entry— Si clé introuvable ? est FAUX, ce nœud supprime l'entrée ayant la clé spécifiée du tableau associatif. Si clé introuvable ? est VRAI, ce nœud ne fait rien.
    0Modify Entry only if found (valeur par défaut) — Si clé introuvable ? est FAUX, ce nœud remplace la valeur associée existante par la nouvelle valeur. Si clé introuvable ? est VRAI, ce nœud ne fait rien.
    1Add or Modify Entry— Si clé introuvable ? est FAUX, ce nœud remplace la valeur associée existante par la nouvelle valeur. Si clé introuvable ? est VRAI, ce nœud ajoute la nouvelle clé et la valeur associée au tableau associatif.
  • ci32.png valeur —

    valeur spécifie la nouvelle valeur de l'entrée avec la clé associée.

  • imap.png tableau associatif —

    tableau associatif renvoie le tableau associatif résultant.

  • istr.png clé —

    clé renvoie la même valeur que l'entrée clé sur le côté gauche du nœud de bordure.

  • ibool.png clé introuvable ? —

    • Exemples

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

    • labview\examples\Collections\Map Collection - Word Counting.vi
    • labview\examples\Design Patterns\Registration Map\Registration Map Usage.lvproj