`lst_to_pkg(K;V)`

Returns a new package value by accepting a list of keys and a list of values of equal lengths.

Syntax

lst_to_pkg(K;V)

Input

Argument	Type	Description
`K`	list-value	A list whose elements will be used as the keys in the new package Keys may only contain alphanumeric characters or underscores and must begin with an alphabetic character. They may not contain any spaces or other special characters.
`V`	list-value	A list whose elements will be used as the values in the new package Text values must be enclosed in single quotes.

Return Value

Returns a package-value. Elements from list-value K will be used as the package keys. Elements from list-value V will be used as package values.

If the lists specified to K and V have different lengths, an error is returned.

If either K or V is N/A, an error is returned.

Example

In order to create a package-value using lst_to_pkg(K;V) in the same line as the comprising lists are declared, <letseq> should be used.

<letseq keys="{lst('pi' 'vowels' 'existence')}" vals="{lst(3.14159 lst('a' 'e' 'i' 'o' 'u') 'To be or not to be') }">
  <set important_ideas="{lst_to_pkg(@keys;@vals)}"/>
  <colord cols="store"/>
  <willbe name="pi" value="'{@important_ideas['pi']}'"/>
</letseq>

Example: Using in blocks

In order to use lst_to_pkg(K;V) in a block, use <set> after the opening tag of the <block> element:

<block name="test_pkg" keys="{lst('pi' 'vowels' 'existence')}" vals="{lst(3.14159 lst('a' 'e' 'i' 'o' 'u') 'To be or not to be') }">
  <set important_ideas="{lst_to_pkg(@keys;@vals)}"/>
  <colord cols="store"/>
  <willbe name="test" value="'{@important_ideas['pi']}'"/>
  <willbe name="secondvowel" value="'{@important_ideas.vowels.2}'"/>
</block>