6.58 SDDS_GetMatrixOfRows

• name:
  SDDS_GetMatrixOfRows
• 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, int32_t *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.
• see also:
  • SDDS_NumberOfErrors
  • SDDS_PrintErrors
  • SDDS_SetColumnsOfInterest
  • SDDS_SetRowsOfInterest