Debian Codegraph @

html/oop_glib.html

raw
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_glib_new(), oop_glib_delete(), oop_glib_return()</title>
4 <link rel="stylesheet" type="text/css" href="style.css">
5 </head><body>
6
7 <h2>oop_glib_new(), oop_glib_delete(), oop_glib_return()</h2>
8
9 <pre>
10 #include &lt;oop.h&gt;
11 #include &lt;glib.h&gt;
12 #include &lt;oop-glib.h&gt;
13
14 oop_source *oop_glib_new();
15 void oop_glib_delete();
16 void *oop_glib_return();
17 </pre>
18
19 <h3>Description.</h3>
20
21 <dl>
22 <dt><b>oop_glib_new</b>
23 <dd>Create a liboop source which uses the
24 <a href="http://www.gtk.org/rdp/glib/glib-the-main-event-loop.html">GLib
25 Main Event Loop</a> for events. There is only one such event loop (the
26 GMainLoop structure really represents a loop context, not a fully independent
27 event loop), so this function is global. You may call it multiple times; it
28 will return the same event source, but keep count of the number of users.<p>
29
30 Events will be dispatched when the GLib event loop is run, either directly
31 via g_main_run() or indirectly via gtk_main().<p>
32
33 <dt><b>oop_glib_delete</b>
34 <dd>Delete the liboop source created with oop_glib_new(). This decrements the
35 count of users; when oop_glib_delete has been called as many times as
36 oop_glib_new, the event source is removed.<p>
37
38 <dt><b>oop_glib_return</b>
39 <dd>Since the event source is run by GLib, the main program has no direct way
40 of retrieving a value returned by an event handler. Instead, when the loop is
41 terminated, the GLib event loop should return, and the caller can use this
42 function to request the specific termination code.<p>
43
44 This function isn't commonly used. <b>Furthermore, GLib event loop termination
45 does not currently work.</b> In other words, ignore this for now.
46 </dl>
47
48 <hr><a href="ref.html">liboop reference</a></body></html>