QDict: Introduce new iteration API
authorLuiz Capitulino <lcapitulino@redhat.com>
Mon, 7 Jun 2010 19:07:29 +0000 (16:07 -0300)
committerLuiz Capitulino <lcapitulino@redhat.com>
Thu, 1 Jul 2010 17:27:13 +0000 (14:27 -0300)
commitf2b07f35d2ee1c6a501d1e3c68c0db42c70751fd
tree765bea2ee1cbe966fedcf962e00e48aedf343d19
parent0d078b2adec72fd74b00defb260724b33e87e184
QDict: Introduce new iteration API

It's composed of functions qdict_first() and qdict_next(), plus
functions to access QDictEntry values.

This API was suggested by Markus Armbruster <armbru@redhat.com> and
it offers full control over the iteration process.

The usage is simple, the following example prints all keys in 'qdict'
(it's hopefully better than any English description):

   QDict *qdict;
   const QDictEntry *ent;

   [...]

   for (ent = qdict_first(qdict); ent; ent = qdict_next(qdict, ent)) {
        printf("%s ", qdict_entry_key(ent));
    }

Signed-off-by: Luiz Capitulino <lcapitulino@redhat.com>
qdict.c
qdict.h