description:
Returns a two-dimensional array of the rows of interest from the columns of interest, as specified by such functions
as SDDS_SetRowsOfInterest and SDDS_SetColumnsOfInterest. All selected columns must have the same data
type.
synopsis:
#include "SDDS.h"
void *SDDS_GetMatrixOfRows(SDDS_TABLE *SDDS_table, long *n_rows)
arguments:
SDDS_table : Address of the SDDS_TABLE structure for the data set.
n_rows: The address of a location into which the number of rows in the array is written.
return value:
On success, returns a pointer to the array, which has type data-type**, where data-type
is the data type of the columns. The array is newly-allocated, and may be modified as needed by the caller.
Note that for type SDDS_STRING, data-type is char *.
On failure, returns NULL and records an error message.