PushMapPosition()

Syntaxe

PushMapPosition(Map())
Description
Mémorise l'élément courant (s'il existe).
Il pourra être restauré à l'aide de PopMapPosition().

Arguments

Map() La map à utiliser.

Valeur de retour

Aucune.

Remarques

La position est sauvegardée dans une structure de pile, donc plusieurs appels à cette fonction sont possibles.

Cette fonction peut être utilisée pour sauvegarder l'élément courant, donc une itération peut être utilisée sur la carte en utilisant NextMapElement() ou foreach et l'élément courant peut être restauré après l'itération en utilisant PopMapPosition(). Plusieurs appels peuvent être faits à cette fonction, aussi longtemps que chacun est équilibré avec un appel PopMapPosition() correspondant.

Note: Il n'est pas permis de supprimer un élément qui a été mémorisé, en utilisant DeleteMapElement() ou ClearMap() function. Cela peut entraîner un plantage lors de l'appel de PopMapPosition() parce que la mémoire n'est plus valide.

Exemple

  NewMap Nombres()
  Nombres("A") = 1
  Nombres("B") = 2
  Nombres("C") = 5
  Nombres("D") = 3
  Nombres("E") = 2
  Nombres("F") = 5
  
  ; Une simple élimination de doublon
  ;
  ForEach Nombres()
    Value = Nombres()
    PushMapPosition(Nombres())
    While NextMapElement(Nombres())
      If Nombres() = Value 
        DeleteMapElement(Nombres())
      EndIf
    Wend
    PopMapPosition(Nombres())
  Next
  
  ForEach Nombres()
    Debug Nombres()
  Next

Voir aussi

PopMapPosition(), FindMapElement(), NextMapElement(), ResetMap(), ForEach

OS Supportés

Tous

<- PopMapPosition() - Map Index - ResetMap() ->