MapLookup¶
MapLookup verwendet einen Hashing Algorithmus um ein Element im Map-Objekt zu finden.
- data = MapLookup(hMap, ssKey)
- data = MapLookup(hMap, ssKey, default_value)
Returnwert
data ist eine reelle-, komplexe- oder String-Matrix. Im Fehlerfall liefert die Funktion den Wert 0.
Parameter
- hMap
hMap ist die Zugriffsnummer des mit MapCreate erzeugten Map-Objekts.
- ssKey
ssKey ist eine skalare Zeichenkette, mit der auf ein Element des Map-Objekts zugegriffen werden kann.
- default_value
Die Funktion liefert den Wert default_value, falls der Schlüssel ssKey im Map-Objekt nicht existiert. default_value kann eine reelle-, komplexe- oder String-Matrix sein.
Kommentar
Um zu prüfen, ob der zurückgelieferte Wert gültig ist, kann die Funktion ObjGetOk aufgerufen werden. Wenn z. B. der Schlüssel ssKey in der Tabelle nicht existiert, liefert die Funktion ObjGetOk den Wert FALSE (0).
Beispiel
hMap = MapCreate();
MapSetAt(hMap, "Test1", [1,2,3,4,5,6]);
MapSetAt(hMap, "Test2", [2,5,7,6,3,1,6,7,8]);
MapSetAt(hMap, "Header1", ["1,5l", "4 Valves"]);
if (MapKeyExists(hMap, "Test2") {
rmStr = MapLookup(hMap, "Test2");
} else
// set to default:
rmStr = [2,5,7,6,3,1,6,7,8];
}
// or
rmStr = MapLookup(hMap, "Test1", [2,5,7,6,3,1,6,7,8]);
History
Version |
Beschreibung |
|---|---|
5.7.0 |
Neuer Parameter default_value zugefügt. |
4.2.0 |
Die Funktion liefert auch String-Daten mit 0-Zeichen. |
Siehe auch
id-2108427