_MapFirst

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

Slouží ke zjištění první věty v mapě, jejiž identifikátor je hMap. Jestliže alespoň jedna věta existuje, vrací true a:

• Pozice Pos bude naplněna hodnotou pozice následující tedy druhé věty. Pozice je důležitá pro následující funkci _MapNext.
• Klíč Key bude naplněn hodnotou klíče z první věty.
• Hodnota Value bude naplněna hodnotou z první věty.

Funkce se v kombinaci s funkcí _MapNext používá k procházení jednotlivých vět mapy hMap.

Jestliže bude mapa otevřena jako netříděná, budou procházené věty vraceny v nesetříděném pořadí.

Jestliže bude mapa otevřena jako tříděná, budou procházené věty vraceny v setříděném pořadí. Způsob řazení (vzestupně / sestupně) bude záležet na nastavení.

Podívejte se na: Procedury a funkce - Mapy

Příklad:

dim hMap  : Longint;
dim Pos   : Longint;
dim Ident : Longint;
dim Jmeno : StringZ;
..
hMap := MapOpen(MAP_LONG);
..
MapAdd(hMap, O[dbIdent], O[oJmeno]);
...
if(_MapFirst(hMap, Pos, Ident, Jmeno))then
    repeat
        ...
    until _MapNext(hMap, Pos, Ident, Jmeno) = false;
endif
MapClose(hMap);