nanohttp-client.h File Reference

Go to the source code of this file.

Classes
struct	httpc_conn
Typedefs
typedef httpc_conn	httpc_conn_t
Functions
herror_t	httpc_init (int argc, char **argv)
void	httpc_destroy (void)
httpc_conn_t *	httpc_new (void)
void	httpc_free (httpc_conn_t *conn)
void	httpc_close_free (httpc_conn_t *conn)
int	httpc_set_header (httpc_conn_t *conn, const char *key, const char *value)
int	httpc_add_header (httpc_conn_t *conn, const char *key, const char *value)
void	httpc_add_headers (httpc_conn_t *conn, const hpair_t *values)
int	httpc_set_basic_authorization (httpc_conn_t *conn, const char *user, const char *password)
int	httpc_set_basic_proxy_authorization (httpc_conn_t *conn, const char *user, const char *password)
herror_t	httpc_get (httpc_conn_t *conn, hresponse_t **out, const char *urlstr)
herror_t	httpc_post_begin (httpc_conn_t *conn, const char *url)
herror_t	httpc_post_end (httpc_conn_t *conn, hresponse_t **out)
herror_t	httpc_mime_begin (httpc_conn_t *conn, const char *url, const char *related_start, const char *related_start_info, const char *related_type)
herror_t	httpc_mime_next (httpc_conn_t *conn, const char *content_id, const char *content_type, const char *transfer_encoding)
herror_t	httpc_mime_end (httpc_conn_t *conn, hresponse_t **out)
herror_t	httpc_mime_send_file (httpc_conn_t *conn, const char *content_id, const char *content_type, const char *transfer_encoding, const char *filename)

---

Typedef Documentation

typedef struct httpc_conn httpc_conn_t

---

Function Documentation

int httpc_add_header (  httpc_conn_t *  conn, const char *  key, const char *  value )

Adds a header element (key, value) pair. Returns: 0 on success, -1 on failure. See also: httpc_set_header httpc_add_headers General Header Fields Request Header Fields

void httpc_add_headers (  httpc_conn_t *  conn, const hpair_t *  values )

Adds a list of (key, value) pairs. See also: httpc_set_header httpc_add_header General Header Fields Request Header Fields

void httpc_close_free (  httpc_conn_t *  conn  )

Close and release a connection See also: httpc_close httpc_free

void httpc_destroy (  void   )

Destroys the nanoHTTP client module. See also: httpc_init

void httpc_free (  httpc_conn_t *  conn  )

Release a connection (use httpc_close_free() instead) See also: httpc_close_free

herror_t httpc_get (  httpc_conn_t *  conn, hresponse_t **  out, const char *  urlstr )

Invoke a "GET" method request and receive the response Returns: H_OK on success See also: HTTP_REQUEST_GET

herror_t httpc_init (  int  argc, char **  argv )

Initializes the nanoHTTP client module. Parameters: argc  Argument count. argv  Argument vector. Returns: H_OK on succes or a herror_t struct on failure. See also: httpc_destroy herror_t

herror_t httpc_mime_begin (  httpc_conn_t *  conn, const char *  url, const char *  related_start, const char *  related_start_info, const char *  related_type )

Begin MIME multipart/related POST request Returns: H_OK on success or error flag See also: nanohttp_mime_page

herror_t httpc_mime_end (  httpc_conn_t *  conn, hresponse_t **  out )

Finish MIME request and get the response Returns: H_OK on success See also: nanohttp_mime_page

herror_t httpc_mime_next (  httpc_conn_t *  conn, const char *  content_id, const char *  content_type, const char *  transfer_encoding )

Send boundary and part header and continue with next part Returns: H_OK on success See also: nanohttp_mime_page

herror_t httpc_mime_send_file (  httpc_conn_t *  conn, const char *  content_id, const char *  content_type, const char *  transfer_encoding, const char *  filename )

Send boundary and part header and continue with next part Returns: H_OK on success See also: nanohttp_mime_page

httpc_conn_t* httpc_new (  void   )

Creates a new HTTP client connection object. You need to create at least one HTTP client connection to communicate via HTTP. Returns: A pointer to a httpc_conn_t structure on success, NULL on error. See also: httpc_conn_t

herror_t httpc_post_begin (  httpc_conn_t *  conn, const char *  url )

Start a "POST" method request Returns: H_OK on success or error flag See also: HTTP_REQUEST_POST httpc_post_end

herror_t httpc_post_end (  httpc_conn_t *  conn, hresponse_t **  out )

End a "POST" method and receive the response. You MUST call httpc_post_end() before! Returns: H_OK on success See also: httpc_post_begin HTTP_REQUEST_POST

int httpc_set_basic_authorization (  httpc_conn_t *  conn, const char *  user, const char *  password )

Sets a HEADER_AUTHORIZATION header. Parameters: conn  The HTTP connection. user  The username. password  The password. See also: httpc_set_header HEADER_AUTHORIZATION

int httpc_set_basic_proxy_authorization (  httpc_conn_t *  conn, const char *  user, const char *  password )

Sets a HEADER_PROXY_AUTHORIZATION header. Parameters: conn  The HTTP connection. user  The username. password  The password. See also: httpc_set_header HEADER_PROXY_AUTHORIZATION

int httpc_set_header (  httpc_conn_t *  conn, const char *  key, const char *  value )

Sets header element (key,value) pair. Returns: 0 on success or failure (yeah!), 1 if a (key,value) pair was replaced. See also: httpc_add_header httpc_add_headers General Header Fields Request Header Fields

---