ncurses 4.1
[ncurses.git] / Ada95 / html / curs_beep.3x.html
1 <HTML>
2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
3 <PRE>
4        <STRONG>beep</STRONG>, <STRONG>flash</STRONG> - <STRONG>curses</STRONG> bell and screen flash routines
5
6
7 </PRE>
8 <H2>SYNOPSIS</H2><PRE>
9        <STRONG>#include</STRONG> <STRONG>&lt;curses.h&gt;</STRONG>
10
11        <STRONG>int</STRONG> <STRONG>beep(void);</STRONG>
12        <STRONG>int</STRONG> <STRONG>flash(void);</STRONG>
13
14
15 </PRE>
16 <H2>DESCRIPTION</H2><PRE>
17        The <STRONG>beep</STRONG> and <STRONG>flash</STRONG> routines are used to alert the terminal
18        user.  The routine <STRONG>beep</STRONG> sounds an  audible  alarm  on  the
19        terminal,  if  possible;  otherwise  it flashes the screen
20        (visible bell).  The routine <STRONG>flash</STRONG> flashes the screen, and
21        if  that  is  not  possible, sounds the alert.  If neither
22        alert is possible, nothing happens.  Nearly all  terminals
23        have  an  audible  alert (bell or beep), but only some can
24        flash the screen.
25
26
27 </PRE>
28 <H2>RETURN VALUE</H2><PRE>
29        These routines return <STRONG>OK</STRONG> if they  succeed  in  beeping  or
30        flashing, <STRONG>ERR</STRONG> otherwise.
31
32
33 </PRE>
34 <H2>EXTENSIONS</H2><PRE>
35        SVr4's  beep  and flash routines always returned <STRONG>OK</STRONG>, so it
36        was not possible to tell when the beep or flash failed.
37
38
39 </PRE>
40 <H2>PORTABILITY</H2><PRE>
41        These functions are defined in the  XSI  Curses  standard,
42        Issue  4.  Like SVr4, it specifies that they always return
43        <STRONG>OK</STRONG>.
44
45
46 </PRE>
47 <H2>SEE ALSO</H2><PRE>
48        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68 </PRE>
69 </BODY>
70 </HTML>