Result sets
The result set object is a container for records returned from a target.
ZOOM_resultset ZOOM_connection_search(ZOOM_connection,
ZOOM_query q);
ZOOM_resultset ZOOM_connection_search_pqf(ZOOM_connection c,
const char *q);
void ZOOM_resultset_destroy(ZOOM_resultset r);
|
void ZOOM_resultset_option_set (ZOOM_resultset r,
const char *key,
const char *val);
const char *ZOOM_resultset_option_get (ZOOM_resultset r,
const char *key);
size_t ZOOM_resultset_size (ZOOM_resultset r);
|
The number of hits also called result-count is returned by function ZOOM_resultset_size.
Table 3-2. ZOOM Result set Options
| Option | Description | Default |
|---|---|---|
| piggyback | True (1) if piggyback should be used in searches; false (0) if not. | 1 |
| start | Offset of first record to be retrieved from target. First record has offset 0 unlike the protocol specifications where first record has position 1. | 0 |
| count | Number of records to be retrieved. | 0 |
| elementSetName | Element-Set name of records. Most targets should honor element set name B and F for brief and full respectively. | none |
| preferredRecordSyntax | Preferred Syntax, such as USMARC, SUTRS, etc. | none |
| schema | Schema for retrieval, such as Gils-schema, Geo-schema, etc. | none |
| smallSetUpperBound | If hits is less than or equal to this value, then target will return all records using small element set name | 0 |
| largeSetLowerBound | If hits is greater than this value, the target will return no records. | 1 |
| mediumSetPresentNumber | This value represents the number of records to be returned as part of a search when when hits is less than or equal to large set lower bound and if hits is greater than small set upper bound. | 0 |
| smallSetElementSetName | The element set name to be used for small result sets. | none |
| mediumSetElementSetName | The element set name to be for medium-sized result sets. | none |
| databaseName | One or more database names separated by character plus (+). | Default |
| setname | Name of Result Set (Result Set ID). If this option isn't set, the ZOOM module will automatically allocate a result set name. | default |