# curs_beep 3x

    curs_beep(3x)                                             curs_beep(3x)

## NAME

           beep, flash - curses bell and screen flash routines

## SYNOPSIS

           #include <curses.h>

           int beep(void);
           int flash(void);

## DESCRIPTION

           The beep and flash routines are used to alert the terminal
           user.  The routine beep sounds an  audible  alarm  on  the
           terminal,  if  possible;  otherwise  it flashes the screen
           (visible bell).  The routine flash flashes the screen, and
           if  that  is  not  possible, sounds the alert.  If neither
           alert is possible, nothing happens.  Nearly all  terminals
           have  an  audible  alert (bell or beep), but only some can
           flash the screen.

## RETURN VALUE

           These routines return OK if they  succeed  in  beeping  or
           flashing, ERR otherwise.

## EXTENSIONS

           SVr4's  beep  and flash routines always returned OK, so it
           was not possible to tell when the beep or flash failed.

## PORTABILITY

           These functions are described in the XSI Curses  standard,
           Issue  4.  Like SVr4, it specifies that they always return
           OK.

## SEE ALSO

           curses(3x)

                                                              curs_beep(3x)