[xml_io.h] curl Wrapper

contents



#include "standard.h"
#include "xml_dfn.h"
#include "gstream.h"



   The module [xml_io] uses the library libcurl to fetch files identified
   by an URL.



Init & Quit

c_bool XML_io_init()
init URL-based I/O; to be called once during application setup
void XML_io_quit()
quit URL-based I/O; to be called once during application cleanup


Creation & Disposal

UrlHdl_T XML_io_create_handle()
create a new handle to access URL-based resources;
RC: handle or NULL

void XML_io_drop_handle(UrlHdl_T hdl)
drop handle 'hdl'


URL Access

c_bool XML_io_download
       (
         UrlHdl_T hdl, c_string url, c_string auth,
         GStream_T stream, void (*prMsg)(c_string msg)
       )
download resource 'url' and put it to 'stream';
optionally, use 'auth' (format: user:passwd) for authorisation
and 'prMsg' as error callback