MapAdd

(    hMap  : Longint;
     Key   : ...;
     Value : ...)

Do mapy , jejiž identifikátor je hMap vkládá hodnotu Value pod klíčem Key. Hodnota Value může být jakéhokoliv jednoduchého typu, které makrojazyk používá:

• Byte
• Word
• Integer
• Longint
• String
• StringZ
• Date
• DateTime

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 výsledky při další práci s mapou nemusí být správné.

Mapa musí být otevřená, jinak hlásí chybu.

Jestliže byla mapa otevřena jako netříděná, nebo tříděná bez nastavení duplikace, a přidávaný klíč již v mapě existuje, bude předchozí záznam přepsán novým.

Jestliže potřebujete změnit obsah u tříděné kolekce s duplicitním obsahem, použijte proceduru MapModByPos.

Podívejte se na: Procedury a funkce - Mapy

Příklad:

dim hMap : Longint;
hMap := MapOpen(MAP_LONG);
MapAdd(hMap, 100, O[oJmeno]);
...
MapClose(hMap);

dim hMap : Longint;
hMap := MapOpen(MAP_STRING);
MapAdd(hMap, "Abcd", 12356);
...
MapClose(hMap);