AddMapElement()

Syntaxe

Resultat = AddMapElement(Map(), Clef [, Option])

Ajoute un nouvel élément vide dans la Map() avec la 'Clef' spécifiée. Ce nouvel élément devient l'élément courant de la map. Si le 'Resultat' est 0, alors l'élément n'a pas été ajouté (manque de mémoire), sinon il représente le pointeur vers les données de l'élément.

'Options' est un paramètre facultatif qui peut prendre l'une des valeurs suivantes:

  #PB_Map_ElementCheck  : Vérifie si un élément avec la 'Clef' spécifiée existe déjà dans la map, et le remplace (défaut).
  #PB_Map_NoElementCheck: Pas de vérification, donc si un élément avec la 'Clef' spécifiée existe déjà, il sera perdu
                      et inaccessible. Sa mémoire ne sera libérée que si ClearMap() est utilisé. Ce mode est plus rapide
                      mais plus dangereux: à utiliser avec précaution.

Note: Cette fonction n'est pas obligatoire pour gérer les maps, car les éléments sont ajoutés automatiquement quand une valeur est affectée à une nouvelle clef.

Exemple:

  NewMap Country.s()
  
  ; Manière normale d'ajouter un élément
  Country("US") = "United State"
  
  ; Et maintenant en utilisant 'AddMapElement()'
  AddMapElement(Country(), "FR")
  Country() = "France"
  
  ForEach Country()
    Debug Country()
  Next

OS Supportés

Tous