AddMapElement()
Syntax
Ergebnis = AddMapElement(Map(), Key$ [, Flags])Beschreibung
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