_MapFind

(   hMap  : Longint;
    Key   : ...;
dim Value : ...[;
dim Pos   : Longint]) : Byte

Vrací true a hodnotu Value, jestliže existuje naprosto stejný klíč Key v mapě, jejiž identifikátor je hMap. Klíč Key musí být takového typu, který byl zvolen při otevírání mapy. Jestliže použijete jiný typ, nemusí být nutně hlášena chyba protože automaticky dojde k vnitřnímu převodu typů, ale funkce nemusí vracet korektní výsledek.

Jestliže potřebujete najít nejbližší vyšší klíč, použijte makrofunksi _MapSearch. To je ovšem možné pouze u map typu MAP_SORT_xxx.

Funkcí _MapExistsKey lze otestovat přítomnost klíče bez návratu hodnoty.

Nepovinný parametr Pos vrací pozici následující věty v mapě. Má význam pouze v případě tříděné mapy. Jinak vrací 0. Jestliže bude nalezena poslední věta, vrací také 0.

Podívejte se na: Procedury a funkce - Mapy

Příklad:

dim hMap : Longint;
dim sJm  : StringZ;
hMap := MapOpen(MAP_LONG);
MapAdd(hMap, O[dbIdent], O[oJmeno]);
...
if(_MapFind(hMap, O[dbIdent], sJm))then
    ...
endif