This method should resize the matrix to the specified size. The method is not required, but if it is not present all Output matrices must be pre-allocated prior to calling the NAG function.
This method may be called in two circumstances:
Prior to calling the algorithmic engine in order to allocate an Output matrix.
After the call to the algorithmic engine when the amount of useful data held in the matrix is less that its original size, i.e. the Output matrix is oversized. This tends to come about if most of the matrix is used as workspace and only the first n1 elements contain useful information. If resize is called in this circumstance then the matrix should be resized, preserving the contents. There is no requirement to resize in this situation, it is purely for convenience.
The type of n1
, can be any type as long as an integer literal or a types::f77_integer
can be cast to it.