curses.h revision 1.7.2.1
1 /* 2 * Copyright (c) 1981, 1993 3 * The Regents of the University of California. All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 3. All advertising materials mentioning features or use of this software 14 * must display the following acknowledgement: 15 * This product includes software developed by the University of 16 * California, Berkeley and its contributors. 17 * 4. Neither the name of the University nor the names of its contributors 18 * may be used to endorse or promote products derived from this software 19 * without specific prior written permission. 20 * 21 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31 * SUCH DAMAGE. 32 * 33 * @(#)curses.h 8.2 (Berkeley) 11/29/93 34 */ 35 36 #ifndef _CURSES_H_ 37 #define _CURSES_H_ 38 39 #include <sys/types.h> 40 #include <sys/cdefs.h> 41 42 #include <stdio.h> 43 #include <compat.h> 44 45 /* 46 * The following #defines and #includes are present for backward 47 * compatibility only. They should not be used in future code. 48 * 49 * START BACKWARD COMPATIBILITY ONLY. 50 */ 51 #ifndef _CURSES_PRIVATE 52 #define bool char 53 #define reg register 54 55 #ifndef TRUE 56 #define TRUE (1) 57 #endif 58 #ifndef FALSE 59 #define FALSE (0) 60 #endif 61 62 #define _puts(s) tputs(s, 0, __cputchar) 63 #define _putchar(c) __cputchar(c) 64 65 /* Old-style terminal modes access. */ 66 #define baudrate() (cfgetospeed(&__baset)) 67 #define crmode() cbreak() 68 #define erasechar() (__baset.c_cc[VERASE]) 69 #define killchar() (__baset.c_cc[VKILL]) 70 #define nocrmode() nocbreak() 71 #define ospeed (cfgetospeed(&__baset)) 72 #endif /* _CURSES_PRIVATE */ 73 74 extern char GT; /* Gtty indicates tabs. */ 75 extern char NONL; /* Term can't hack LF doing a CR. */ 76 extern char UPPERCASE; /* Terminal is uppercase only. */ 77 78 extern int My_term; /* Use Def_term regardless. */ 79 extern char *Def_term; /* Default terminal type. */ 80 81 /* Termcap capabilities. */ 82 extern char AM, BS, CA, DA, EO, HC, IN, MI, MS, NC, NS, OS, 83 PC, UL, XB, XN, XT, XS, XX; 84 extern char *AL, *BC, *BT, *CD, *CE, *CL, *CM, *CR, *CS, *DC, *DL, 85 *DM, *DO, *ED, *EI, *K0, *K1, *K2, *K3, *K4, *K5, *K6, 86 *K7, *K8, *K9, *HO, *IC, *IM, *IP, *KD, *KE, *KH, *KL, 87 *KR, *KS, *KU, *LL, *MA, *ND, *NL, *RC, *SC, *SE, *SF, 88 *SO, *SR, *TA, *TE, *TI, *UC, *UE, *UP, *US, *VB, *VS, 89 *VE, *al, *dl, *sf, *sr, 90 *AL_PARM, *DL_PARM, *UP_PARM, *DOWN_PARM, *LEFT_PARM, 91 *RIGHT_PARM; 92 93 /* END BACKWARD COMPATIBILITY ONLY. */ 94 95 /* 8-bit ASCII characters. */ 96 #define unctrl(c) __unctrl[(c) & 0xff] 97 #define unctrllen(ch) __unctrllen[(ch) & 0xff] 98 99 extern char *__unctrl[256]; /* Control strings. */ 100 extern char __unctrllen[256]; /* Control strings length. */ 101 102 /* 103 * A window an array of __LINE structures pointed to by the 'lines' pointer. 104 * A line is an array of __LDATA structures pointed to by the 'line' pointer. 105 * 106 * IMPORTANT: the __LDATA structure must NOT induce any padding, so if new 107 * fields are added -- padding fields with *constant values* should ensure 108 * that the compiler will not generate any padding when storing an array of 109 * __LDATA structures. This is to enable consistent use of memcmp, and memcpy 110 * for comparing and copying arrays. 111 */ 112 typedef struct { 113 char ch; /* the actual character */ 114 115 #define __STANDOUT 0x01 /* Added characters are standout. */ 116 char attr; /* attributes of character */ 117 } __LDATA; 118 119 #define __LDATASIZE (sizeof(__LDATA)) 120 121 typedef struct { 122 #define __ISDIRTY 0x01 /* Line is dirty. */ 123 #define __ISPASTEOL 0x02 /* Cursor is past end of line */ 124 #define __FORCEPAINT 0x04 /* Force a repaint of the line */ 125 u_int flags; 126 u_int hash; /* Hash value for the line. */ 127 size_t *firstchp, *lastchp; /* First and last chngd columns ptrs */ 128 size_t firstch, lastch; /* First and last changed columns. */ 129 __LDATA *line; /* Pointer to the line text. */ 130 } __LINE; 131 132 typedef struct __window { /* Window structure. */ 133 struct __window *nextp, *orig; /* Subwindows list and parent. */ 134 size_t begy, begx; /* Window home. */ 135 size_t cury, curx; /* Current x, y coordinates. */ 136 size_t maxy, maxx; /* Maximum values for curx, cury. */ 137 short ch_off; /* x offset for firstch/lastch. */ 138 __LINE **lines; /* Array of pointers to the lines */ 139 __LINE *lspace; /* line space (for cleanup) */ 140 __LDATA *wspace; /* window space (for cleanup) */ 141 142 #define __ENDLINE 0x001 /* End of screen. */ 143 #define __FLUSH 0x002 /* Fflush(stdout) after refresh. */ 144 #define __FULLLINE 0x004 /* Line width = terminal width. */ 145 #define __FULLWIN 0x008 /* Window is a screen. */ 146 #define __IDLINE 0x010 /* Insert/delete sequences. */ 147 #define __SCROLLWIN 0x020 /* Last char will scroll window. */ 148 #define __SCROLLOK 0x040 /* Scrolling ok. */ 149 #define __CLEAROK 0x080 /* Clear on next refresh. */ 150 #define __WSTANDOUT 0x100 /* Standout window */ 151 #define __LEAVEOK 0x200 /* If curser left */ 152 u_int flags; 153 } WINDOW; 154 155 /* Curses external declarations. */ 156 extern WINDOW *curscr; /* Current screen. */ 157 extern WINDOW *stdscr; /* Standard screen. */ 158 159 extern struct termios __orig_termios; /* Terminal state before curses */ 160 extern struct termios __baset; /* Our base terminal state */ 161 extern int __tcaction; /* If terminal hardware set. */ 162 163 extern int COLS; /* Columns on the screen. */ 164 extern int LINES; /* Lines on the screen. */ 165 166 extern char *ttytype; /* Full name of current terminal. */ 167 168 #define ERR (0) /* Error return. */ 169 #define OK (1) /* Success return. */ 170 171 /* Standard screen pseudo functions. */ 172 #define addbytes(s, n) __waddbytes(stdscr, s, n, 0) 173 #define addch(ch) waddch(stdscr, ch) 174 #define addnstr(s, n) waddnstr(stdscr, s, n) 175 #define addstr(s) __waddbytes(stdscr, s, strlen(s), 0) 176 #define clear() wclear(stdscr) 177 #define clrtobot() wclrtobot(stdscr) 178 #define clrtoeol() wclrtoeol(stdscr) 179 #define delch() wdelch(stdscr) 180 #define deleteln() wdeleteln(stdscr) 181 #define erase() werase(stdscr) 182 #define getch() wgetch(stdscr) 183 #define getstr(s) wgetstr(stdscr, s) 184 #define inch() winch(stdscr) 185 #define insch(ch) winsch(stdscr, ch) 186 #define insertln() winsertln(stdscr) 187 #define move(y, x) wmove(stdscr, y, x) 188 #define refresh() wrefresh(stdscr) 189 #define standend() wstandend(stdscr) 190 #define standout() wstandout(stdscr) 191 #define waddbytes(w, s, n) __waddbytes(w, s, n, 0) 192 #define waddstr(w, s) __waddbytes(w, s, strlen(s), 0) 193 194 /* Standard screen plus movement pseudo functions. */ 195 #define mvaddbytes(y, x, s, n) mvwaddbytes(stdscr, y, x, s, n) 196 #define mvaddch(y, x, ch) mvwaddch(stdscr, y, x, ch) 197 #define mvaddnstr(y, x, s, n) mvwaddnstr(stdscr, y, x, s, n) 198 #define mvaddstr(y, x, s) mvwaddstr(stdscr, y, x, s) 199 #define mvdelch(y, x) mvwdelch(stdscr, y, x) 200 #define mvgetch(y, x) mvwgetch(stdscr, y, x) 201 #define mvgetstr(y, x, s) mvwgetstr(stdscr, y, x, s) 202 #define mvinch(y, x) mvwinch(stdscr, y, x) 203 #define mvinsch(y, x, c) mvwinsch(stdscr, y, x, c) 204 #define mvwaddbytes(w, y, x, s, n) \ 205 (wmove(w, y, x) == ERR ? ERR : __waddbytes(w, s, n, 0)) 206 #define mvwaddch(w, y, x, ch) \ 207 (wmove(w, y, x) == ERR ? ERR : waddch(w, ch)) 208 #define mvwaddnstr(w, y, x, s, n) \ 209 (wmove(w, y, x) == ERR ? ERR : waddnstr(w, s, n)) 210 #define mvwaddstr(w, y, x, s) \ 211 (wmove(w, y, x) == ERR ? ERR : __waddbytes(w, s, strlen(s), 0)) 212 #define mvwdelch(w, y, x) \ 213 (wmove(w, y, x) == ERR ? ERR : wdelch(w)) 214 #define mvwgetch(w, y, x) \ 215 (wmove(w, y, x) == ERR ? ERR : wgetch(w)) 216 #define mvwgetstr(w, y, x, s) \ 217 (wmove(w, y, x) == ERR ? ERR : wgetstr(w, s)) 218 #define mvwinch(w, y, x) \ 219 (wmove(w, y, x) == ERR ? ERR : winch(w)) 220 #define mvwinsch(w, y, x, c) \ 221 (wmove(w, y, x) == ERR ? ERR : winsch(w, c)) 222 223 /* Psuedo functions. */ 224 #define clearok(w, bf) \ 225 ((bf) ? ((w)->flags |= __CLEAROK) : ((w)->flags &= ~__CLEAROK)) 226 #define flushok(w, bf) \ 227 ((bf) ? ((w)->flags |= __FLUSH) : ((w)->flags &= ~__FLUSH)) 228 #define getyx(w, y, x) \ 229 (y) = (w)->cury, (x) = (w)->curx 230 #define leaveok(w, bf) \ 231 ((bf) ? ((w)->flags |= __LEAVEOK) : ((w)->flags &= ~__LEAVEOK)) 232 #define scrollok(w, bf) \ 233 ((bf) ? ((w)->flags |= __SCROLLOK) : ((w)->flags &= ~__SCROLLOK)) 234 #define winch(w) \ 235 ((w)->lines[(w)->cury]->line[(w)->curx].ch & 0177) 236 237 /* Public function prototypes. */ 238 int box __P((WINDOW *, int, int)); 239 int cbreak __P((void)); 240 int delwin __P((WINDOW *)); 241 int echo __P((void)); 242 int endwin __P((void)); 243 char *fullname __P((char *, char *)); 244 char *getcap __P((char *)); 245 int gettmode __P((void)); 246 void idlok __P((WINDOW *, int)); 247 WINDOW *initscr __P((void)); 248 char *longname __P((char *, char *)); 249 int mvcur __P((int, int, int, int)); 250 int mvprintw __P((int, int, const char *, ...)); 251 int mvscanw __P((int, int, const char *, ...)); 252 int mvwin __P((WINDOW *, int, int)); 253 int mvwprintw __P((WINDOW *, int, int, const char *, ...)); 254 int mvwscanw __P((WINDOW *, int, int, const char *, ...)); 255 WINDOW *newwin __P((int, int, int, int)); 256 int nl __P((void)); 257 int nocbreak __P((void)); 258 int noecho __P((void)); 259 int nonl __P((void)); 260 int noraw __P((void)); 261 int overlay __P((WINDOW *, WINDOW *)); 262 int overwrite __P((WINDOW *, WINDOW *)); 263 int printw __P((const char *, ...)); 264 int raw __P((void)); 265 int resetty __P((void)); 266 int savetty __P((void)); 267 int scanw __P((const char *, ...)); 268 int scroll __P((WINDOW *)); 269 int setterm __P((char *)); 270 int sscans __P((WINDOW *, const char *, ...)); 271 WINDOW *subwin __P((WINDOW *, int, int, int, int)); 272 int suspendwin __P((void)); 273 int touchline __P((WINDOW *, int, int, int)); 274 int touchoverlap __P((WINDOW *, WINDOW *)); 275 int touchwin __P((WINDOW *)); 276 int vwprintw __P((WINDOW *, const char *, _BSD_VA_LIST_)); 277 int vwscanw __P((WINDOW *, const char *, _BSD_VA_LIST_)); 278 int waddch __P((WINDOW *, int)); 279 int waddnstr __P((WINDOW *, const char *, int)); 280 int wclear __P((WINDOW *)); 281 int wclrtobot __P((WINDOW *)); 282 int wclrtoeol __P((WINDOW *)); 283 int wdelch __P((WINDOW *)); 284 int wdeleteln __P((WINDOW *)); 285 int werase __P((WINDOW *)); 286 int wgetch __P((WINDOW *)); 287 int wgetstr __P((WINDOW *, char *)); 288 int winsch __P((WINDOW *, int)); 289 int winsertln __P((WINDOW *)); 290 int wmove __P((WINDOW *, int, int)); 291 int wprintw __P((WINDOW *, const char *, ...)); 292 int wrefresh __P((WINDOW *)); 293 int wscanw __P((WINDOW *, const char *, ...)); 294 char *wstandend __P((WINDOW *)); 295 char *wstandout __P((WINDOW *)); 296 int vwprintw __P((WINDOW *, const char *, _BSD_VA_LIST_)); 297 298 /* Private functions that are needed for user programs prototypes. */ 299 void __cputchar __P((int)); 300 int __waddbytes __P((WINDOW *, const char *, int, int)); 301 302 /* Private functions. */ 303 #ifdef _CURSES_PRIVATE 304 void __CTRACE __P((const char *, ...)); 305 u_int __hash __P((char *, int)); 306 void __id_subwins __P((WINDOW *)); 307 int __mvcur __P((int, int, int, int, int)); 308 void __restore_stophandler __P((void)); 309 void __set_stophandler __P((void)); 310 void __set_subwin __P((WINDOW *, WINDOW *)); 311 void __startwin __P((void)); 312 void __stop_signal_handler __P((int)); 313 void __swflags __P((WINDOW *)); 314 int __touchline __P((WINDOW *, int, int, int, int)); 315 int __touchwin __P((WINDOW *)); 316 char *__tscroll __P((const char *, int)); 317 int __waddch __P((WINDOW *, __LDATA *)); 318 319 /* Private #defines. */ 320 #define min(a,b) (a < b ? a : b) 321 #define max(a,b) (a > b ? a : b) 322 323 /* Private externs. */ 324 extern int __echoit; 325 extern int __endwin; 326 extern int __pfast; 327 extern int __rawmode; 328 extern int __noqch; 329 #endif 330 331 /* Termcap functions. */ 332 int tgetent __P((char *, char *)); 333 int tgetnum __P((char *)); 334 int tgetflag __P((char *)); 335 char *tgetstr __P((char *, char **)); 336 char *tgoto __P((char *, int, int)); 337 int tputs __P((char *, int, void (*)(int))); 338 339 #endif /* !_CURSES_H_ */ 340
Indexes created Sat Sep 27 14:09:57 GMT 2025