Next: SDDS_GetColumnDefinition
Up: Manual Pages
Previous: SDDS_GetArrayType
Contents
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.
Robert Soliday
2006-06-29