The array of character data supplied is assumed to hold
" adjacent fixed-length
strings (without terminating nulls), each of length
" characters. This function
allocates memory and creates a null-terminated copy of each of these strings. It also
creates an array of
" pointers which point at the start of each of these new
strings. A pointer to this index array is returned.
The memory used is allocated in a single block and should later be de-allocated using astFree.
"pointers pointing at the start of each null-terminated output string.
The returned pointer should be passed to astFree to de-allocate the memory used when it is no longer required. This will free both the index array and the memory used by the strings it points at.
A NULL pointer will also be returned if the value of
" is zero, in which case no
memory is allocated.
A pointer value of NULL will also be returned if this function is invoked with the global error status set or if it fails for any reason.