diff options
author | Daniel Silverstone <dsilvers@digital-scurf.org> | 2014-06-03 15:40:28 +0100 |
---|---|---|
committer | Daniel Silverstone <dsilvers@digital-scurf.org> | 2014-06-03 15:40:28 +0100 |
commit | d35b27d44e72bd4d1f2e532085af52b8120e8138 (patch) | |
tree | 73af135355c018be6bc27d83145e0bc13073ce68 /desktop/searchweb.h | |
parent | e2633a9a6353e54df75256f1bc5bb8ddad897597 (diff) | |
download | netsurf-d35b27d44e72bd4d1f2e532085af52b8120e8138.tar.gz netsurf-d35b27d44e72bd4d1f2e532085af52b8120e8138.tar.bz2 |
Add iterator for search providers
Diffstat (limited to 'desktop/searchweb.h')
-rw-r--r-- | desktop/searchweb.h | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/desktop/searchweb.h b/desktop/searchweb.h index 612e9bdd1..b3b3902cf 100644 --- a/desktop/searchweb.h +++ b/desktop/searchweb.h @@ -78,6 +78,30 @@ nserror search_web_omni(const char *term, enum search_web_omni_flags flags, stru */ nserror search_web_select_provider(int selection); + +/** + * Iterate the search providers, returning their names. + * + * \param from Index to start iteration from. Use 0 to begin iteration. + * Use the value returned from search_web_iterate_providers to + * continue an iteration. + * \param name Pointer to fill in with the search provider name requested. + * \return -1 if there are no more, otherwise the iterator for the next item. + * + * \verb + * ssize_t iter; + * const char *name; + * ... + * for (iter = search_web_iterate_providers(0, &name); + * iter != -1; + * iter = search_web_iterate_providers(iter, &name)) { + * do_something_with(name); + * } + * \endverb + */ +ssize_t search_web_iterate_providers(ssize_t from, const char **name); + + /** * Initialise the web search operations. * |