10e3d5408SPeter Wemm /****************************************************************************
24a1a9510SRong-En Fan * Copyright 2020 Thomas E. Dickey *
30e3d5408SPeter Wemm * Copyright 1998-2013,2014 Free Software Foundation, Inc. *
40e3d5408SPeter Wemm * *
50e3d5408SPeter Wemm * Permission is hereby granted, free of charge, to any person obtaining a *
60e3d5408SPeter Wemm * copy of this software and associated documentation files (the *
70e3d5408SPeter Wemm * "Software"), to deal in the Software without restriction, including *
80e3d5408SPeter Wemm * without limitation the rights to use, copy, modify, merge, publish, *
90e3d5408SPeter Wemm * distribute, distribute with modifications, sublicense, and/or sell *
100e3d5408SPeter Wemm * copies of the Software, and to permit persons to whom the Software is *
110e3d5408SPeter Wemm * furnished to do so, subject to the following conditions: *
120e3d5408SPeter Wemm * *
130e3d5408SPeter Wemm * The above copyright notice and this permission notice shall be included *
140e3d5408SPeter Wemm * in all copies or substantial portions of the Software. *
150e3d5408SPeter Wemm * *
160e3d5408SPeter Wemm * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
170e3d5408SPeter Wemm * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
180e3d5408SPeter Wemm * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
190e3d5408SPeter Wemm * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
200e3d5408SPeter Wemm * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
210e3d5408SPeter Wemm * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
220e3d5408SPeter Wemm * THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
230e3d5408SPeter Wemm * *
240e3d5408SPeter Wemm * Except as contained in this notice, the name(s) of the above copyright *
250e3d5408SPeter Wemm * holders shall not be used in advertising or otherwise to promote the *
260e3d5408SPeter Wemm * sale, use or other dealings in this Software without prior written *
270e3d5408SPeter Wemm * authorization. *
280e3d5408SPeter Wemm ****************************************************************************/
290e3d5408SPeter Wemm
300e3d5408SPeter Wemm /****************************************************************************
310e3d5408SPeter Wemm * Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995 *
324a1a9510SRong-En Fan * and: Eric S. Raymond <esr@snark.thyrsus.com> *
330e3d5408SPeter Wemm * and: Thomas E. Dickey 1996-on *
340e3d5408SPeter Wemm * and: Juergen Pfeifer 2009 *
350e3d5408SPeter Wemm ****************************************************************************/
360e3d5408SPeter Wemm
370e3d5408SPeter Wemm /*
380e3d5408SPeter Wemm * beep.c
390e3d5408SPeter Wemm *
400e3d5408SPeter Wemm * The routine beep().
410e3d5408SPeter Wemm *
420e3d5408SPeter Wemm */
430e3d5408SPeter Wemm
440e3d5408SPeter Wemm #include <curses.priv.h>
454a1a9510SRong-En Fan
460e3d5408SPeter Wemm #ifndef CUR
470e3d5408SPeter Wemm #define CUR SP_TERMTYPE
480e3d5408SPeter Wemm #endif
490e3d5408SPeter Wemm
500e3d5408SPeter Wemm MODULE_ID("$Id: lib_beep.c,v 1.18 2020/02/02 23:34:34 tom Exp $")
510e3d5408SPeter Wemm
520e3d5408SPeter Wemm /*
530e3d5408SPeter Wemm * beep()
540e3d5408SPeter Wemm *
557a69bbfbSPeter Wemm * Sound the current terminal's audible bell if it has one. If not,
567a69bbfbSPeter Wemm * flash the screen if possible.
570e3d5408SPeter Wemm *
580e3d5408SPeter Wemm */
590e3d5408SPeter Wemm
NCURSES_EXPORT(int)600e3d5408SPeter Wemm NCURSES_EXPORT(int)
610e3d5408SPeter Wemm NCURSES_SP_NAME(beep) (NCURSES_SP_DCL0)
620e3d5408SPeter Wemm {
634a1a9510SRong-En Fan int res = ERR;
644a1a9510SRong-En Fan
654a1a9510SRong-En Fan T((T_CALLED("beep(%p)"), (void *) SP_PARM));
660e3d5408SPeter Wemm
670e3d5408SPeter Wemm #ifdef USE_TERM_DRIVER
681759abf3SPeter Wemm if (SP_PARM != 0)
690e3d5408SPeter Wemm res = CallDriver_1(SP_PARM, td_doBeepOrFlash, TRUE);
700e3d5408SPeter Wemm #else
710e3d5408SPeter Wemm /* FIXME: should make sure that we are not in altchar mode */
721759abf3SPeter Wemm if (cur_term == 0) {
730e3d5408SPeter Wemm res = ERR;
740e3d5408SPeter Wemm } else if (bell) {
750e3d5408SPeter Wemm res = NCURSES_PUTP2_FLUSH("bell", bell);
760e3d5408SPeter Wemm } else if (flash_screen) {
77 res = NCURSES_PUTP2_FLUSH("flash_screen", flash_screen);
78 _nc_flush();
79 }
80 #endif
81
82 returnCode(res);
83 }
84
85 #if NCURSES_SP_FUNCS
86 NCURSES_EXPORT(int)
beep(void)87 beep(void)
88 {
89 return NCURSES_SP_NAME(beep) (CURRENT_SCREEN);
90 }
91 #endif
92