Langage BASICMaps

FindMapElement

Commande de map

Syntaxe

Cherche une clé sans la créer. Si la clé existe, son entrée devient l’entrée courante.

FindMapElement(<map>(), <key>)

Les éléments

<map>La table, écrite avec ses parenthèses vides : stock(). Ce doit être une variable NewMap ou un champ table d’un enregistrement.
<key>La clé cherchée, convertie en texte. La recherche distingue majuscules et minuscules.

Rend

1 si la clé existe, 0 sinon.

À savoir

  • C’est la façon de tester une clé. Lire m("key") crée l’entrée avec la valeur par défaut quand elle manque.
  • Si la clé manque, la table n’a plus d’entrée courante : MapKey() rend "" et lire m() arrête le programme avec « BASIC map has no current element ».
  • Dans un FOREACH sur la même table, FindMapElement déplace le curseur de la boucle. Encadrez-le de PushMapPosition() et PopMapPosition().

Exemple

NewMap stock.i()stock("apple") = 3IF FindMapElement(stock(), "apple") THEN Console(Str(stock()))   ' 3IF FindMapElement(stock(), "plum") = 0 THEN Console("no plum")   ' no plumConsole(Str(MapSize(stock())))   ' 1
Dans le manuel : Tableaux, listes et maps

Voir aussi