AddMapElement()

Syntaxe

Resultat = AddMapElement(Map(), Cle$ [, Options])

Ajoute un nouvel élément vide.

Arguments

Map()	La map à utiliser.
Cle$	La clé du nouvel élément.
Options (optionnel)	Peut être une des valeurs suivantes: #PB_Map_ElementCheck : Vérifie si un élément existe déjà avec la même clé et le remplace (défaut). #PB_Map_NoElementCheck: Pas de vérification, donc si un élément existe déjà avec la même clé, 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. A utiliser avec précaution.

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.
La valeur renvoyée est un pointeur vers le nouvel élément.

Remarques

Ce nouvel élément devient l'élément courant.

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 clé.

Exemple

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

Voir aussi

DeleteMapElement(), ClearMap(), MapSize()

OS Supportés

Tous