Mapy

Mapy se používají k ukládání a následnému velice rychlému vyhledávání hodnot podle klíčů. Mapy umožňují uchovávání hodnot všech datových typů, které makrojazyk používá. Počet hodnot v mapách je omezen pouze kapacitou paměti.

Mapy se dělí na dvě skupiny:

• Netříděné
• Tříděné

Netříděné mapy

Tyto mapy se používají tam, kde není potřeba řazení podle ukládaných klíčů.

Vlastnosti:

• Nejrychlejší vyhledávání podle klíče.
• Mapy lze procházet pouze jedním směrem.
• Klíče nejsou seřazeny.
• Nelze vkládat dva stejné klíče (při vložení stejného klíče dojde k nahrazení původní hodnoty)

Jako klíče lze používat následující makro typy:

Konstanty pro MapOpen	Povolené makro typy klíče	Poznámka
MAP_LONG	Longint, Word, Integer, Byte
MAP_STRING	StringZ	Pro porovnávání se berou v úvahu i háčky a čárky.
MAP_DATE	Date

Tříděné mapy

Tyto mapy se používají tam, kde je potřeba řazení podle ukládaných klíčů.

Vlastnosti:

• Nepatrně pomalejší vyhledávání podle klíče.
• Mapy lze procházet pouze jedním směrem.
• Klíče jsou řazeny podle svého typu již během vkládání.
• Podle volby lze(default) / nelze vkládat dva stejné klíče (MapSetDuplicate).
• Lze volit způsob řazení klíčů vzestupně(default) / sestupně (MapSetSortUp).

Jako klíče lze používat následující makro typy:

Konstanty pro MapOpen	Povolené makro typy klíče	Poznámka
MAP_SORT_LONG	Longint, Word, Integer, Byte
MAP_SORT_STRING	StringZ
MAP_SORT_L_STRING	String	Pro porovnávání se berou v úvahu i háčky a čárky.
MAP_SORT_L_STRING_BIN	String	Porovnání se provede pouze na binární úrovni bez ohledu na háčky a čárky. Klíč se tedy nijak neupraví! Klíč lze tvořit třeba pomocí funkce _StrToCSW.
MAP_SORT_DATE	Date
MAP_SORT_DATE_TIME	DateTime

Práce s mapami

• Mapa se otevírá funkcí _MapOpen. Tam se určuje typ mapy a klíče.
• Mapa se zavírá procedurou MapClose.
• Do mapy se přidává klíč a hodnota procedurou MapAdd.
• Z mapy se jeden klíč se svojí hodnotou maže procedurou MapDel.
• Všechny klíče a hodnoty se najednou mažou procedurou MapDelAll.
• Existenci klíče v mapě zjistíme funkcí _MapExistsKey.
• K vyhledání hodnoty podle klíče slouží funkce _MapFind.
• Počet vět v mapě zjistíme funkcí _MapCount.
• K procházení jednotlivých vět mapy slouží funkce _MapFirst, _MapNext.
• Chování tříděných map lze upravit procedurami MapSetSortUp a MapSetDuplicate.

Podívejte se na: Procedury a funkce - Mapy