The type \ref{State} contains each of the States in the United~States,
with the addition of Washington~DC.
The States are 1-indexed and sorted by \emph{abbreviation}\footnote{
States are sorted by abbreviation rather than the State name beacuse
they are most frequently referenced as such.}.
For operations that involve taking values of all states where order
matters (e.g. for index alignment),
querying the symbol table isn't appropriate,
as it does not guarantee order.
\ref{_for-each-state_} can be used for that purpose;
it exposes the following template values to its body:
\begin{enumerate}
\item \tt{@state_const@} contains the State constant;
\item \tt{@state_upper@} contains the uppercase two-letter State
abbreviation;
\item \tt{@state_lower@} contains the lowercase two-letter State
abbreviation; and
\item \tt{@state_name@} contains the full state name.
\end{enumerate}
This can be used to generate a ^[State vector] by mapping an iteration
index to the State constant~\tt{@state_const@}.
Note that \ref{STATE_NONE} is not in the list.
To ease iteration though ^[State vector]s generated with
\ref{_for-each-state_},
a 52~vector \ref{NVEC_STATE_ALL} and classification \ref{state-all}
are provided.