Previous: SDDS_SetColumnFlags
Up: Manual Pages
Next: SDDS_SetParameters
Previous Page: SDDS_SetColumnFlags
Next Page: SDDS_SetParameters
SDDS_SetColumnsOfInterest(SDDS_TABLE *SDDS_table, SDDS_NAME_ARRAY, long n_entries, char **name), where name is an array of pointers to n_entries NULL-terminated character strings. The columns named in these strings are added to the list of columns deemed to be ``of interest'' by the caller. The order in which the caller gives the column names is recorded, and calls to SDDS_GetRow and SDDS_GetMatrixOfRows return the columns in this order.
SDDS_SetColumnsOfInterest(SDDS_TABLE *SDDS_table, SDDS_NAMES_STRING, char *string), where string is a NULL-terminated character string giving the names of the columns of interest separated by white-space. The columns named in these strings are added to the list of columns deemed to be ``of interest'' by the caller. The order in which the caller gives the column names is recorded, and calls to SDDS_GetRow and SDDS_GetMatrixOfRows return the columns in this order.
SDDS_SetColumnsOfInterest(SDDS_TABLE *SDDS_table, SDDS_NAME_STRINGS, char *string, ..., NULL), where string and all following arguments are NULL-terminated character strings, each giving the name of a column. The list is terminated by the value NULL. The columns named in these strings are added to the list of columns deemed to be ``of interest'' by the caller. The order in which the caller gives the column names is recorded, and calls to SDDS_GetRow and SDDS_GetMatrixOfRows return the columns in this order.
SDDS_SetColumnsOfInterest(SDDS_TABLE *SDDS_table, SDDS_MATCH_STRING, char *string, long logic_mode), where string is a wildcard-containing, NULL-terminated character string to which column names will be matched. The columns so matched are added to the list of columns deemed to be ``of interest'' by the caller. The order in which the caller gives the column names is recorded, and calls to SDDS_GetRow and SDDS_GetMatrixOfRows return the columns in this order. See the manual page for SDDS_Logic for a discussion of the logic_mode parameter.