comparison libgaim/util.h @ 14354:01daacf7b771

[gaim-migrate @ 17060] Make gaim_url_fetch() cancelable and change Yahoo! to take advantage of the changes. Other stuff can be changed later, the important thing is that the API is there. committer: Tailor Script <[e-mail]>

14353:33dc9f22b528

#include "xmlnode.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct _GaimMenuAction
{
	char *label;
	GaimCallback callback;

 * @param ret_passwd The returned password.
 */
gboolean gaim_url_parse(const char *url, char **ret_host, int *ret_port,
						char **ret_path, char **ret_user, char **ret_passwd);

typedef void (*GaimURLFetchCallback) (gpointer data, const char *buf, gsize len);

/**
 * Fetches the data from a URL, and passes it to a callback function.
 *
 * @param url        The URL.

 * @param user_agent The user agent field to use, or NULL.
 * @param http11     TRUE if HTTP/1.1 should be used to download the file.
 * @param cb         The callback function.
 * @param data       The user data to pass to the callback function.
 */
#define gaim_url_fetch(url, full, user_agent, http11, cb, data) \
	gaim_url_fetch_request(url, full, user_agent, http11, NULL, \
		FALSE, cb, data);

/**
 * Fetches the data from a URL, and passes it to a callback function.
 *

 *                   partial URL.
 * @param user_agent The user agent field to use, or NULL.
 * @param http11     TRUE if HTTP/1.1 should be used to download the file.
 * @param request    A HTTP request to send to the server instead of the
 *                   standard GET
 * @param include_headers if TRUE, include the HTTP headers in the
 *                   response
 * @param cb         The callback function.
 * @param data       The user data to pass to the callback function.
 */
void gaim_url_fetch_request(const char *url, gboolean full,
		const char *user_agent, gboolean http11,
		const char *request, gboolean include_headers,
		GaimURLFetchCallback cb, void *data);

/**
 * Decodes a URL into a plain string.
 *
 * This will change hex codes and such to their ascii equivalents.

14354:01daacf7b771

#include "xmlnode.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct _GaimUtilFetchUrlData GaimUtilFetchUrlData;

typedef struct _GaimMenuAction
{
	char *label;
	GaimCallback callback;

 * @param ret_passwd The returned password.
 */
gboolean gaim_url_parse(const char *url, char **ret_host, int *ret_port,
						char **ret_path, char **ret_user, char **ret_passwd);

/**
 * This is the signature used for functions that act as the callback
 * to gaim_util_fetch_url() or gaim_util_fetch_url_request().
 *
 * @param url_data      The same value that was returned when you called
 *                      gaim_fetch_url() or gaim_fetch_url_request().
 * @param user_data     The user data that your code passed into either
 *                      gaim_util_fetch_url() or gaim_util_fetch_url_request().
 * @param url_text      This will be NULL on error.  Otherwise this
 *                      will contain the contents of the URL.
 * @param len           0 on error, otherwise this is the length of buf.
 * @param error_message If something went wrong then this will contain
 *                      a descriptive error message, and buf will be
 *                      NULL and len will be 0.
 */
typedef void (*GaimUtilFetchUrlCallback)(GaimUtilFetchUrlData *url_data, gpointer user_data, const gchar *url_text, gsize len, const gchar *error_message);

/**
 * Fetches the data from a URL, and passes it to a callback function.
 *
 * @param url        The URL.

 * @param user_agent The user agent field to use, or NULL.
 * @param http11     TRUE if HTTP/1.1 should be used to download the file.
 * @param cb         The callback function.
 * @param data       The user data to pass to the callback function.
 */
#define gaim_util_fetch_url(url, full, user_agent, http11, cb, data) \
	gaim_util_fetch_url_request(url, full, user_agent, http11, NULL, \
		FALSE, cb, data);

/**
 * Fetches the data from a URL, and passes it to a callback function.
 *

 *                   partial URL.
 * @param user_agent The user agent field to use, or NULL.
 * @param http11     TRUE if HTTP/1.1 should be used to download the file.
 * @param request    A HTTP request to send to the server instead of the
 *                   standard GET
 * @param include_headers
 *                   If TRUE, include the HTTP headers in the response.
 * @param callback   The callback function.
 * @param data       The user data to pass to the callback function.
 */
GaimUtilFetchUrlData *gaim_util_fetch_url_request(const gchar *url,
		gboolean full, const gchar *user_agent, gboolean http11,
		const gchar *request, gboolean include_headers,
		GaimUtilFetchUrlCallback callback, gpointer data);

/**
 * Cancel a pending URL request started with either
 * gaim_util_fetch_url_request() or gaim_util_fetch_url().
 *
 * @param url_data The data returned when you initiated the URL fetch.
 */
void gaim_util_fetch_url_cancel(GaimUtilFetchUrlData *url_data);

/**
 * Decodes a URL into a plain string.
 *
 * This will change hex codes and such to their ascii equivalents.