File: oop_sys.html

package info (click to toggle)
liboop 1.0.1-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,120 kB
  • sloc: sh: 11,098; ansic: 2,533; makefile: 71
file content (46 lines) | stat: -rw-r--r-- 1,597 bytes parent folder | download | duplicates (8)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
<html><head>
<title>liboop: oop_sys_new(), oop_sys_delete()</title>
<link rel="stylesheet" type="text/css" href="style.css">
</head><body>

<h2>oop_sys_new(), oop_sys_delete()</h2>

<pre>
#include &lt;oop.h&gt;

/* <em>Create and destroy a system event source.</em> */
oop_source_sys *oop_sys_new(void);
void oop_sys_delete(oop_source_sys *sys);
</pre>

<h3>Arguments.</h3>

<dl>
<dt><b>oop_source_sys *sys</b>
<dd>The event source to deallocate and destroy.
</dl>

<h3>Description.</h3>

<dl>
<dt><b>oop_sys_new</b>
<dd>Create a new system event source.  The system event source implements the
event source interface and manages a select() loop.  Once the system event
source is created, use <a href="oop_sys_source.html">oop_sys_source()</a> to
access the event source interface (which lets you register event sinks), and 
<a href="oop_sys_run.html">oop_sys_run()</a> or
<a href="oop_sys_run.html">oop_sys_run_once()</a> to actually process events.
More than one system event source can exist, though it is rarely useful to do
so (since only one may be active at a time).<p>

If a malloc failure occurs creating the system event source, NULL is returned.
It is up to the caller to handle this failure.<p>

<dt><b>oop_sys_delete</b>
<dd>Destroy the system event source <em>sys</em>.  This frees all resources 
associated with the event source.  The source cannot have any active callbacks 
(event sinks) associated with it.<p>
</dl>

<hr><a href="ref.html">liboop reference</a></body></html>