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.

Parameter

Map()	Die Map, zu welcher das Element hinzugefügt werden soll.
Key$	Der Schlüssel (Key) für das neue Element.
Flags (optional)	Kann einer der folgenden Werte sein: #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.

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, und Null bei einem Fehler. Der zurückgegebene Wert ist ein Zeiger auf die neuen Element-Daten.

Anmerkungen

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 States"
  
  ; Das gleiche mittels AddMapElement()
  AddMapElement(Country(), "FR")
  Country() = "France"
  
  ForEach Country()
    Debug Country()
  Next

Siehe auch

DeleteMapElement(), ClearMap(), MapSize()

Unterstützte OS

Alle