cp_httpclient_result(3) - Linux man page

Name

cp_httpclient_result, cp_httpclient_result_destroy, cp_httpclient_result_get_client, cp_httpclient_result_id, cp_httpclient_result_status, cp_httpclient_result_get_response - http call result wrapper

Synopsis

#include <cprops/httpclient.h>

void cp_httpclient_result_destroy(cp_httpclient_result *res);
cp_httpclient *

cp_httpclient_result_get_client(cp_httpclient_result *res);
void *cp_httpclient_result_id(cp_httpclient_result *res); cp_http_result_status: cp_httpclient_result_status(cp_httpclient_result *res);
cp_http_response *: cp_httpclient_result_get_response(cp_httpclient_result *res);

Description

The cp_httpclient api represents HTTP request results as cp_httpclient_result objects. cp_httpclient_fetch(3) returns a cp_httpclient_result object directly, and the asynchronous fetch functions return results to user defined callback functions which accept a cp_httpresult object as their parameter.

cp_httpclient_result_destroy deallocates a cp_httpclient_result object. It should only be called on results returned by cp_httpclient_fetch - the asynchronous interfaces deallocate result objects automatically.

cp_httpclient_result_get_client returns the cp_httpclient object the request was performed on.

cp_httpclient_result_id returns the user assigned id object given as a parameter to an asynchronous fetch function. For cp_httpclient_fetch this is always NULL.

cp_httpclient_result_status returns a cp_http_result_status code describing the response status. cp_http_result_status is an enumerated type defined as

typedef enum
{
    CP_HTTP_RESULT_SUCCESS,
    CP_HTTP_RESULT_CONNECTION_FAILED,
    CP_HTTP_RESULT_CONNECTION_RESET,
    CP_HTTP_RESULT_TIMED_OUT,
    CP_HTTP_RESULT_WRITE_ERROR,
    CP_HTTP_RESULT_READ_ERROR
} cp_http_result_status;

cp_httpclient_result_get_response returns a cp_http_response(3) object representing the server response. This may be NULL on communication failures.

Return Value

cp_httpclient_result_get_client returns the cp_httpclient object the request was performed on.
cp_httpclient_result_id returns the user assigned id for this request if any.
cp_httpclient_result_status returns a cp_http_result_status code describing the response status.
cp_httpclient_result_get_response returns a cp_http_response object representing the server response on success or NULL on communication errors or memory allocation failure.

Referenced By