before a dynamic array can be used, it has to be initialized
with this routine. the initial length provided here, can
avoid reallocations and memory copying, if approximated
correctly enough. if none is specified, the provided container
initially will be of size 0.
Nodes of different colours represent the following:
Solid arrows point from a procedure to one which it calls. Dashed
arrows point from an interface to procedures which implement that interface.
This could include the module procedures in a generic interface or the
implementation in a submodule of an interface in a parent module.