`$` Enumerate¶

x$y    $[x;y]

Where

x is a symbol containing the name of a global variable d
d is a list
y is a list
d~distinct d
items of y are all items of d

returns y as an enumeration of d, using x as the name of the enumeration domain. Using built-in Enumerate:

q)d:`a`b`c
q)y:`a`b`c`b`a`b`c`c`c`c`c`c`c
q)show e:`d$y;
`d$`a`b`c`b`a`b`c`c`c`c`c`c`c

Values are stored as indices and so need less space.

q)"i"$e
0 1 2 1 0 1 2 2 2 2 2 2 2i

Changing one lookup value (in d) has the same effect as changing those values in the enumeration, while the indices backing e are unchanged.

q)d[0]:`o
q)e
`d$`o`b`c`b`o`b`c`c`c`c`c`c`c
q)"i"$e
0 1 2 1 0 1 2 2 2 2 2 2 2i

To get x and y from e:

q)key e
`d
q)value e
`o`b`c`b`o`b`c`c`c`c`c`c`c

Ensure all items of y are in d

When creating an enumeration using $, the domain of the enumeration must be in d, otherwise a cast error is signalled. In this example `c is not in the domain:

q)y:`a`b`c`b`a`b`c`c`c`c`c`c`c
q)x:`a`b
q)`x$y
'cast

To expand the domain, use ? (Enum Extend) instead of $.

Errors¶

error	cause
cast	item/s of `y` not in `d`

Enum Extend, Enumeration, $ dollar
Enumerations
Q for Mortals §7.5 Enumerations , §8.5 Foreign Keys and Virtual Columns

$ Enumerate¶

Errors¶

`$` Enumerate¶