-/**
- \fn ZEBRA_RES zebra_scan(ZebraHandle zh, ODR stream, \
- Z_AttributesPlusTerm *zapt, oid_value attributeset, \
- int *position, int *num_entries, ZebraScanEntry **list, \
- int *is_partial)
- \brief performs Scan (Z39.50 style)
- \param zh session handle
- \param stream ODR handle for result
- \param zapt Attribute plus Term (start term)
- \param attributeset Attributeset for Attribute plus Term
- \param position input/output position
- \param num_entries number of terms requested / returned
- \param list list of resulting terms (ODR allocated)
- \param is_partial upon return 1=partial, 0=complete
+
+/** \brief returns number of term info terms assocaited with result set
+ \param zh session handle
+ \param setname result set name
+ \param num_terms number of terms returned in this integer
+
+ This function is used in conjunction with zebra_result_set_term_info.
+ If operation was successful, ZEBRA_OK is returned; otherwise
+ ZEBRA_FAIL is returned (typically non-existing setname)
+*/
+YAZ_EXPORT
+ZEBRA_RES zebra_result_set_term_no(ZebraHandle zh, const char *setname,
+ int *num_terms);
+
+/** \brief returns information about a term assocated with a result set
+ \param zh session handle
+ \param setname result set name
+ \param no the term we want to know about (0=first, 1=second,..)
+ \param count the number of occurrences of this term, aka hits (output)
+ \param approx about hits: 0=exact,1=approx (output)
+ \param termbuf buffer for term string (intput, output)
+ \param termlen size of termbuf (input=max, output=actual length)
+ \param term_ref_id if non-NULL *term_ref_id holds term reference
+
+ Returns information about one search term associated with result set.
+ Use zebra_result_set_term_no to read total number of terms associated
+ with result set. If this function can not return information,
+ due to no out of range or bad result set name, ZEBRA_FAIL is
+ returned.
+ The passed termbuf must be able to hold at least *termlen characters.
+ Upon completion, *termlen holds actual length of search term.
+*/
+YAZ_EXPORT
+ZEBRA_RES zebra_result_set_term_info(ZebraHandle zh, const char *setname,
+ int no, zint *count, int *approx,
+ char *termbuf, size_t *termlen,
+ const char **term_ref_id);
+
+
+/** \brief performs Scan (Z39.50 style)
+ \param zh session handle
+ \param stream ODR handle for result
+ \param zapt Attribute plus Term (start term)
+ \param attributeset Attributeset for Attribute plus Term
+ \param position input/output position
+ \param num_entries number of terms requested / returned
+ \param entries list of resulting terms (ODR allocated)
+ \param is_partial upon return 1=partial, 0=complete
+ \param setname limit scan by this set (NULL means no limit)