PushMapPosition()

Syntax

PushMapPosition(Map())

Merkt sich das aktuelle Element (sofern eines vorhanden) der Map, wodurch es später mittels PopMapPosition() wieder hergestellt werden kann. Die Position wird in einer "Stack-Struktur" gespeichert, dadurch sind mehrere Aufrufe dieser Funktion möglich.

Parameter

Map()

Die zu verwendende Map.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Diese Funktion kann verwendet werden, um sich das aktuelle Element zu merken. Damit kann mit Hilfe von NextMapElement() oder ForEach ein Map-Durchlauf gemacht werden, und das aktuelle Element kann nach dem Durchlauf mittels PopMapPosition() wieder hergestellt werden. Mehrere Aufrufe dieser Funktion können erfolgen, solange jeder davon später mit einem korrespondierenden PopMapPosition() Aufruf ausgeglichen wird.

Hinweis: Es ist nicht erlaubt, mit Hilfe der DeleteMapElement() oder ClearMap() Funktionen ein gemerktes aktuelles Element zu löschen. Dies kann in einen Absturz resultieren, wenn PopMapPosition() aufgerufen wird, da der Elemente-Speicher nicht länger gültig ist.

Beispiel

  NewMap Numbers()
  Numbers("A") = 1
  Numbers("B") = 2
  Numbers("C") = 5
  Numbers("D") = 3
  Numbers("E") = 2
  Numbers("F") = 5
  
  ; Eine einfache doppelte Löschung mit Hilfe eines verschachtelten Durchlaufs
  ;
  ForEach Numbers()
    Value = Numbers()
    PushMapPosition(Numbers())
    While NextMapElement(Numbers())
      If Numbers() = Value 
        DeleteMapElement(Numbers())
      EndIf
    Wend
    PopMapPosition(Numbers())
  Next
  
  ForEach Numbers()
    Debug Numbers()
  Next

Siehe auch

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

Unterstützte OS

Alle