Previous: SDDS_GetAssociateNames
Up: Manual Pages
Next: SDDS_GetColumnDefinition
Previous Page: SDDS_GetAssociateNames
Next Page: SDDS_GetColumnDefinition

SDDS_GetColumn

• name:
  SDDS_GetColumn
• description:
  Returns a pointer to the data for a named column for the current data table of a data set.
• synopsis: #include "SDDS.h"
  void *SDDS_GetColumn(SDDS_TABLE *SDDS_table, char *column_name);
• arguments:
  • SDDS_table: Address of the SDDS_TABLE structure for the data set.
  • column_name: A NULL-terminated character string giving the name of the column to return.
• return value:
  On success, returns the address of a newly-created copy of the ``rows of interest'' from the named column. This array has type data-type*, where data-type is the data type of the column. Note that for type SDDS_STRING, data-type is char *. The number of rows is available from SDDS_CountRowsOfInterest.

  On failure, returns NULL and records an error message.

• see also:
  • SDDS_GetMatrixFromColumn
  • SDDS_NumberOfErrors
  • SDDS_PrintErrors
  • SDDS_SetRowsOfInterest