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>