_MapNext

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

Slouží ke zjištění následující věty od pozice Pos v mapě, jejiž identifikátor je hMap. Jestliže je při vstupu do funkce pozice Pos různá od nuly, vrací true a:

• Klíč Key bude naplněn hodnotou klíče z věty na pozici Pos.
• Hodnota Value bude naplněna hodnotou z věty na pozici Pos.

Jestliže bude existovat následující věta od pozice Pos, vrací v parametru Pos její pozici. Jestliže je při vstupu do funkce pozice Pos rovna nule, vrací false a parametry Pos, Key a Value nebudou naplněny!

Funkce se v kombinaci s funkcí _MapFirst 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);