Subversion Repositories

?revision_form?Rev ?revision_input??revision_submit??revision_endform?

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
3 magnus 1 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 
<html><head>
3 
<title>liboop: oop_www_register(), oop_www_cancel(), oop_www_memory()</title>
4 
<link rel="stylesheet" type="text/css" href="style.css">
5 
</head><body>
6 
 
7 
<h2>oop_www_register(), oop_www_cancel(), oop_www_memory()</h2>
8 
 
9 
<pre>
10 
#include &lt;oop.h&gt;
11 
#include &lt;HTEvent.h&gt;
12 
#include &lt;oop-www.h&gt;
13 
 
14 
void oop_www_register(oop_source *source);
15 
void oop_www_cancel();
16 
void oop_www_memory();
17 
</pre>
18 
 
19 
<h3>Arguments.</h3>
20 
 
21 
<dl>
22 
<dt><b>oop_source *source</b>
23 
<dd>The event source to use.  The adapter will use this event source to wait
24 
asynchronously for network communication.<p>
25 
</dl>
26 
 
27 
<h3>Description.</h3>
28 
 
29 
<dl>
30 
<dt><b>oop_www_register</b>
31 
<dd>Register a liboop <em>source</em> with the
32 
<a href="http://www.w3.org/Library/">W3C Protocol Library</a> (libwww).
33 
The adapter acts as an event manager for the libwww
34 
<a href="http://www.w3.org/Library/src/HTEvent.html">HTEvent module</a>,
35 
replacing the
36 
<a href="http://www.w3.org/Library/src/HTEvtLst.html">default event
37 
manager</a>; it relies on the supplied source for actual event handling.
38 
Refer to the libwww documentation for the details of its event architecture.<p>
39 
 
40 
<dt><b>oop_www_cancel</b>
41 
<dd>Unregister liboop with libwww.  This frees resources associated with the
42 
adapter, and leaves libwww with no event manager.  You may use
43 
<b>HTEventInit</b> in the
44 
<a href="http://www.w3.org/Library/src/HTInit.html">HTInit module</a> to
45 
reinstate the libwww default event manager.  The adapter can have no active
46 
events when it is deleted.  (Take care; libwww tends to cache persistent
47 
connections to Web servers, which may cause events to be registered even if
48 
there are no open requests.)<p>
49 
 
50 
<dt><b>oop_www_memory</b>
51 
<dd>Set <a href="alloc">oop_malloc, oop_realloc, and oop_free</a> to
52 
<a href="http://www.w3.org/Library/src/HTMemory.html">HTMemory_malloc
53 
and HTMemory_free</a>, respectively.  You do not need to do this, but it
54 
may help to keep your memory allocations consistent with the libwww
55 
framework.  If you do this, do so before calling any other liboop functions.
56 
</dl>
57 
 
58 
<hr><a href="ref">liboop reference</a></body></html>