X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=doc%2Fzoom.xml;h=1a4efe09cf32205bf0f6522d3f8fdff19304677d;hp=b08d798c8ad69243e95ff1505cf1696ffe4b8dc6;hb=cd8a27308e5bb886f561b517d091437c7afbf53c;hpb=3599bbc013ec757862d8a2d6e62aa6a432ba4514 diff --git a/doc/zoom.xml b/doc/zoom.xml index b08d798..1a4efe0 100644 --- a/doc/zoom.xml +++ b/doc/zoom.xml @@ -1,4 +1,4 @@ - + Building clients with ZOOM @@ -497,36 +497,7 @@ - Options - - Most &zoom; objects provide a way to specify options to change behavior. - From an implementation point of view a set of options is just like - an associative array / hash array, etc. - - - ZOOM_options ZOOM_options_create (void); - - ZOOM_options ZOOM_options_create_with_parent (ZOOM_options parent); - - void ZOOM_options_destroy (ZOOM_options opt); - - - const char *ZOOM_options_get (ZOOM_options opt, const char *name); - - void ZOOM_options_set (ZOOM_options opt, const char *name, - const char *v); - - - typedef const char *(*ZOOM_options_callback) - (void *handle, const char *name); - - ZOOM_options_callback - ZOOM_options_set_callback (ZOOM_options opt, - ZOOM_options_callback c, - void *handle); - - - Scsn + Scan This section describes an interface for Scan. Scan is not an official part of the ZOOM model yet. The result of a scan operation @@ -544,6 +515,12 @@ void ZOOM_scanset_destroy (ZOOM_scanset scan); + + const char *ZOOM_scanset_option_get (ZOOM_scanset scan, + const char *key); + + void ZOOM_scanset_option_set (ZOOM_scanset scan, const char *key, + const char *val); The scan set is created by function @@ -561,8 +538,73 @@ of the actual term respectively. A scan set may be freed by a call to function ZOOM_scanset_destroy. - - + Functions ZOOM_scanset_option_get and + ZOOM_scanset_option_set retrieves and sets + an option respectively. + + + ZOOM Scan Set Options + + + + + + + Option + Description + Default + + + + + numberNumber of Scan Terms requested in next scan. + After scan it holds the actual number of terms returend. + 10 + + positionPreferred Position of term in response + in next scan; actual position after completion of scan. + 1 + + stepSizeStep Size + 0 + + scanStatusAn integer indicating the Scan Status + of last scan. + 0 + + +
+ +
+ Options + + Most &zoom; objects provide a way to specify options to change behavior. + From an implementation point of view a set of options is just like + an associative array / hash array, etc. + + + ZOOM_options ZOOM_options_create (void); + + ZOOM_options ZOOM_options_create_with_parent (ZOOM_options parent); + + void ZOOM_options_destroy (ZOOM_options opt); + + + const char *ZOOM_options_get (ZOOM_options opt, const char *name); + + void ZOOM_options_set (ZOOM_options opt, const char *name, + const char *v); + + + typedef const char *(*ZOOM_options_callback) + (void *handle, const char *name); + + ZOOM_options_callback + ZOOM_options_set_callback (ZOOM_options opt, + ZOOM_options_callback c, + void *handle); + + Events If you're developing non-blocking applications, you have to deal