File: oop_rl.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 (47 lines) | stat: -rw-r--r-- 1,633 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
47
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 
<html><head>
<title>liboop: oop_readline_register(), oop_readline_cancel()</title>
<link rel="stylesheet" type="text/css" href="style.css">
</head><body>

<h2>oop_readline_register(), oop_readline_cancel()</h2>

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

void oop_readline_register(oop_source *source);
void oop_readline_cancel(oop_source *source);
</pre>

<h3>Arguments.</h3>

<dl>
<dt><b>oop_source *source</b>
<dd>The event source to use.  The adapter will use this event source to wait
asynchronously for console input.<p>
</dl>

<h3>Description.</h3>

<dl>
<dt><b>oop_readline_register</b>
<dd>Register a liboop <em>source</em> with the
<a href="http://cnswww.cns.cwru.edu/~chet/readline/rltop.html">GNU Readline 
Library</a>.  The adapter responds asynchronously to console input and notifies 
Readline when it arrives via rl_callback_read_char().  You should use the 
Readline <a href="http://cnswww.cns.cwru.edu/~chet/readline/readline.html#SEC38">alternate
interface</a> to prompt the user and receive input.<p>

Note well that Readline will
<a href="http://cnswww.cns.cwru.edu/~chet/readline/readline.html#SEC40">install
its own signal handlers</a> by default.  Make sure to disable this behavior
by setting rl_catch_signals to zero if you wish to manage signals with 
liboop.<p>

<dt><b>oop_readline_cancel</b>
<dd>Unregister liboop with Readline.  After this is called, 
rl_readback_read_char() will no longer be invoked automatically.<p>
</dl>

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