Author: kkaempf Date: Tue Oct 21 09:09:57 2008 New Revision: 11423 URL: http://svn.opensuse.org/viewcvs/zypp?rev=11423&view=rev Log: document Dataiterator and esp. dataiterator_init Modified: trunk/sat-solver/src/repo.h Modified: trunk/sat-solver/src/repo.h URL: http://svn.opensuse.org/viewcvs/zypp/trunk/sat-solver/src/repo.h?rev=11423&r1=11422&r2=11423&view=diff ============================================================================== --- trunk/sat-solver/src/repo.h (original) +++ trunk/sat-solver/src/repo.h Tue Oct 21 09:09:57 2008 @@ -274,12 +274,32 @@ void datamatcher_free(Datamatcher *ma); int datamatcher_match(Datamatcher *ma, const char *str); -/* Use these like: - Dataiterator di; - dataiterator_init(&di, repo->pool, repo, 0, 0, "bla", SEARCH_SUBSTRING); - while (dataiterator_step(&di)) - dosomething(di.solvid, di.key, di.kv); - dataiterator_free(&di); */ +/* + * Dataiterator + * + * Iterator like interface to 'search' functionality + * + * Dataiterator is per-pool, additional filters can be applied + * to limit the search domain. See dataiterator_init below. + * + * Use these like: + * Dataiterator di; + * dataiterator_init(&di, repo->pool, repo, 0, 0, "bla", SEARCH_SUBSTRING); + * while (dataiterator_step(&di)) + * dosomething(di.solvid, di.key, di.kv); + * dataiterator_free(&di); + */ + +/* + * Initialize dataiterator + * + * di: Pointer to Dataiterator to be initialized + * pool: Search domain for the iterator + * repo: if non-null, limit search to this repo + * solvid: if non-null, limit search to this solvable + * keyname: if non-null, limit search to this keyname + * match: if non-null, limit search to this match + */ int dataiterator_init(Dataiterator *di, Pool *pool, Repo *repo, Id p, Id keyname, const char *match, int flags); void dataiterator_prepend_keyname(Dataiterator *di, Id keyname); -- To unsubscribe, e-mail: zypp-commit+unsubscribe@opensuse.org For additional commands, e-mail: zypp-commit+help@opensuse.org