e2k_results_array_new ()

GArray *            e2k_results_array_new               (void);

Creates a new results array

e2k_results_array_add_from_multistatus ()

void                e2k_results_array_add_from_multistatus
                                                        (GArray *results_array,
                                                         SoupMessage *msg);

Constructs an E2kResult for each response in msg and appends them to results_array.

e2k_results_array_free ()

void                e2k_results_array_free              (GArray *results_array,
                                                         gboolean free_results);

Frees results_array, and optionally its contents

e2k_results_from_multistatus ()

void                e2k_results_from_multistatus        (SoupMessage *msg,
                                                         E2kResult **results,
                                                         gint *nresults);

Parses msg and puts the results in *results and *nresults. The caller should free the data with e2k_results_free()

e2k_results_copy ()

E2kResult *         e2k_results_copy                    (E2kResult *results,
                                                         gint nresults);

Performs a deep copy of results

E2kResultIterFetchFunc ()

E2kHTTPStatus       (*E2kResultIterFetchFunc)           (E2kResultIter *iter,
                                                         E2kContext *ctx,
                                                         E2kOperation *op,
                                                         E2kResult **results,
                                                         gint *nresults,
                                                         gint *first,
                                                         gint *total,
                                                         gpointer user_data);

E2kResultIterFreeFunc ()

void                (*E2kResultIterFreeFunc)            (E2kResultIter *iter,
                                                         gpointer user_data);

e2k_result_iter_new ()

E2kResultIter *     e2k_result_iter_new                 (E2kContext *ctx,
                                                         E2kOperation *op,
                                                         gboolean ascending,
                                                         gint total,
                                                         E2kResultIterFetchFunc fetch_func,
                                                         E2kResultIterFreeFunc free_func,
                                                         gpointer user_data);

Creates a object that can be used to return the results of a Multi-Status query on ctx.

fetch_func will be called to fetch results, and it may update the first and total fields if necessary. If ascending is TRUE, then e2k_result_iter_next() will first return the first result, then the second result, etc. If ascending is FALSE, it will return the last result, then the second-to-last result, etc.

When all of the results returned by the first fetch_func call have been returned to the caller, fetch_func will be called again to get more results. This will continue until fetch_func returns 0 results, or returns an error code.