oop_www_register(), oop_www_cancel(), oop_www_memory()

#include <oop.h>
#include <HTEvent.h>
#include <oop-www.h>

void oop_www_register(oop_source *source);
void oop_www_cancel();
void oop_www_memory();

Arguments.

oop_source *source

The event source to use. The adapter will use this event source to wait asynchronously for network communication.

Description.

oop_www_register

Register a liboop source with the W3C Protocol Library (libwww). The adapter acts as an event manager for the libwww HTEvent module, replacing the default event manager; it relies on the supplied source for actual event handling. Refer to the libwww documentation for the details of its event architecture.

oop_www_cancel

Unregister liboop with libwww. This frees resources associated with the adapter, and leaves libwww with no event manager. You may use HTEventInit in the HTInit module to reinstate the libwww default event manager. The adapter can have no active events when it is deleted. (Take care; libwww tends to cache persistent connections to Web servers, which may cause events to be registered even if there are no open requests.)

oop_www_memory

Set oop_malloc, oop_realloc, and oop_free to HTMemory_malloc and HTMemory_free, respectively. You do not need to do this, but it may help to keep your memory allocations consistent with the libwww framework. If you do this, do so before calling any other liboop functions.