maps

Umožňuje získat hodnotu k danému klíči v daném mapování; klíč předtím převádí na řetězec.

Object maps ( 
    Object map-obj ,
    String key
)
map-obj
Libovolný objekt, se kterým se bude pracovat jako s mapou.
key
Klíč, pod kterým se bude hledat hodnota. Pokud to není řetězec, nejprve se na něj převede.

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

Od funkce map se liší převodem klíče na řetězec před dohledáním hodnoty.

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 mohla používat pro volání akvizice nad assetem; k tomuto účelu je lepší použít speciální funkci acquire s explicitním převodem druhého argumentu na řetězec funkcí asString.

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