map

Umožňuje získat hodnotu k danému klíči v daném mapování. 

Object map ( 
    Object map-obj ,
    Object key
)
map-obj
Libovolný objekt, se kterým se bude pracovat jako s mapou.
key
Klíč, pod kterým se bude hledat hodnota.

Hodnotou map-obj nemusí být jen mapa, ale například jakákoli struktura; funkce použije mapování definované pro daný typ objektu.

K jednoduššímu a přehlednějšímu zápisu vede použití operátoru [].

Klíče v mapě mohou být hodnoty libovolného typu. Pokud lze předpokládat, že klíče jsou řetězce, lze použít funkci maps.

Příklad: Nalezení hodnoty v mapě s řetězci jako klíči
Šablona
{let m := asMap(
  "1", "jedna",
  "2", "dva"
)}

Klíč je řetězec: {map(m, "1")}
Klíč je číslo:   {map(m, 1)}
Klíč je klíč:    {maps(m, 1)}
Výstup
Klíč je řetězec: jedna
Klíč je číslo:   
Klíč je klíč:    jedna

O klíčích v mapě nelze obecně předpokládat, že to budou řetězce. Funkce maps konvertuje libovolný klíč na řetězec, než ho použije.

Dříve se funkce používala pro volání akvizice nad assetem; k tomuto účelu je lepší použít speciální funkci acquire.

Pro vložení příspěvku do diskuse se přihlašte.