DRMS_Array_t * drms_record_getvector ( DRMS_Env_t env,
const char *  recordsetname,
const char *  keylist,
DRMS_Type_t  type,
int  unique,
int *  status 
)

Returns a newly created DRMS_Array_t structure that represents a table of per-record keyword values. recordsetname is a query that selects a set of rows from a DRMS dataseries, and keylist selects a subset of keywords from those rows. The result is a table that contains one column for each item in keylist, and one row for each record that results from evaluation of recordsetname. The column data are stored in DRMS_Array_t:axis0 and the row data are stored in DRMS_Array_t:axis1. keylist contains a comma-separated list of DRMS keyword names and/or 'hidden' database column names (one of recnum, sunum, slotnum, sessionid, sessionns). Data will be converted to the data type type. If unique is set, then resulting duplicate rows (rows where all keyword values are duplicates of another row's keyword values) are discarded before the DRMS_Array_t structure is created. It is the caller's responsibility to free, with drms_free_array, the memory allocated in the creation of the returned DRMS_Array_t structure.

Parameters:
env DRMS session information.
recordsetname A string that specifies a database query. It includes a series name and clauses to extract a subset of records from that series. Please see http://jsoc.stanford.edu/jsocwiki/DrmsNames for more information about database queries.
keylist A comma-separated list of DRMS keyword names and/or 'hidden' database column names (one of recnum, sunum, slotnum, sessionid, sessionns).
type The DRMS data type (DRMS_Type_t) to which the database is to be converted.
unique If set, then the array returned will contain no duplicate rows (each row will contain a unique combination of keyword values).
status Pointer to DRMS status (see drms_statuscodes.h) returned by reference. 0 if successful, non-0 otherwise.
Returns:
The DRMS_Array_t that contains rows of the columns specified in keylist. The caller must free this array with drms_free_array.

Definition at line 14126 of file drms_record.c.


Generated on Wed Sep 20 07:00:33 2017 for JSOC_Documentation by  doxygen 1.5.7.1