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.

id-2108427