4 <STRONG>beep</STRONG>, <STRONG>flash</STRONG> - <STRONG>curses</STRONG> bell and screen flash routines
9 <STRONG>#include</STRONG> <STRONG><curses.h></STRONG>
11 <STRONG>int</STRONG> <STRONG>beep(void);</STRONG>
12 <STRONG>int</STRONG> <STRONG>flash(void);</STRONG>
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
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.
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.
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
47 <H2>SEE ALSO</H2><PRE>
48 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>