AddMapElement()

Syntax

Ergebnis = AddMapElement(Map(), Key$ [, Flags])

Fügt zur 'Map()' ein neues leeres Element mittels des angegebenen Schlüssels 'Key$' hinzu. Dieses neue Element wird das aktuelle Element der Map. Ist das Ergebnis gleich 0, dann wurde das Element nicht erstellt (Speicherplatz reicht nicht aus), andernfalls wird der Zeiger auf die Element-Daten zurückgegeben (nur für fortgeschrittene Verwendung).

'Flags' ist ein optionaler Parameter, der einen der folgenden Werte annehmen kann:

  #PB_Map_ElementCheck  : Überprüft, ob ein Element mit dem gleichen Key bereits existiert, und ersetzt dieses (Standard).
  #PB_Map_NoElementCheck: Keine Element-Überprüfung - wenn also ein vorheriges Element mit dem gleichen Key bereits
                          existierte, wird dieses nicht ersetzt, sondern verbleibt in der Map, jedoch nicht mehr mit direktem Zugriff
                          erreichbar. Es bleibt solange unerreichbar, bis das neu hinzugefügte Element gelöscht wurde. Solche nicht
                          erreichbaren Elemente werden aber immer noch aufgelistet, wenn alle Map-Elemente mittels 
                          ForEach bzw. NextMapElement() durchgegangen werden.
                          Dieser Modus ist schneller, aber auch fehleranfälliger, verwenden Sie ihn daher mit Bedacht.

Hinweis: Diese Funktion ist nicht zwingend beim Umgang mit Maps, da Elemente automatisch hinzugefügt werden, wenn ihnen ein Wert zugewiesen wird.

Beispiel:

  NewMap Country.s()
  
  ; Regulärer Weg zum Hinzufügen eines Elements
  Country("US") = "United State"
  
  ; Das gleiche mittels AddMapElement()
  AddMapElement(Country(), "FR")
  Country() = "France"
  
  ForEach Country()
    Debug Country()
  Next

Unterstützte OS

Alle