MFC: An off-by-one malloc size was corrupting the installer's memory,
[dragonfly.git] / contrib / ncurses-5.4 / include / curses.h.in
blob3b8696014d211c3f7f2711bb78cdb606467159f7
1 /****************************************************************************
2 * Copyright (c) 1998-2003,2004 Free Software Foundation, Inc. *
3 * *
4 * Permission is hereby granted, free of charge, to any person obtaining a *
5 * copy of this software and associated documentation files (the *
6 * "Software"), to deal in the Software without restriction, including *
7 * without limitation the rights to use, copy, modify, merge, publish, *
8 * distribute, distribute with modifications, sublicense, and/or sell *
9 * copies of the Software, and to permit persons to whom the Software is *
10 * furnished to do so, subject to the following conditions: *
11 * *
12 * The above copyright notice and this permission notice shall be included *
13 * in all copies or substantial portions of the Software. *
14 * *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
16 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
18 * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
19 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
20 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
21 * THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
22 * *
23 * Except as contained in this notice, the name(s) of the above copyright *
24 * holders shall not be used in advertising or otherwise to promote the *
25 * sale, use or other dealings in this Software without prior written *
26 * authorization. *
27 ****************************************************************************/
29 /****************************************************************************
30 * Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995 *
31 * and: Eric S. Raymond <esr@snark.thyrsus.com> *
32 * and: Thomas E. Dickey 1996-on *
33 ****************************************************************************/
35 /* $Id: curses.h.in,v 1.148 2004/01/14 23:50:12 tom Exp $ */
37 #ifndef __NCURSES_H
38 #define __NCURSES_H
40 #define CURSES 1
41 #define CURSES_H 1
43 /* This should be defined for the enhanced functionality to be visible.
44 * However, some of the wide-character (enhanced) functionality is missing.
45 * So we do not define it (yet).
46 #define _XOPEN_CURSES 1
49 /* These are defined only in curses.h, and are used for conditional compiles */
50 #define NCURSES_VERSION_MAJOR @NCURSES_MAJOR@
51 #define NCURSES_VERSION_MINOR @NCURSES_MINOR@
52 #define NCURSES_VERSION_PATCH @NCURSES_PATCH@
54 /* This is defined in more than one ncurses header, for identification */
55 #undef NCURSES_VERSION
56 #define NCURSES_VERSION "@NCURSES_MAJOR@.@NCURSES_MINOR@"
58 #include <ncurses_dll.h>
61 * NCURSES_ATTR_T is used to quiet compiler warnings when building ncurses
62 * configured using --disable-macros.
64 #ifdef NCURSES_NOMACROS
65 #define NCURSES_ATTR_T attr_t
66 #endif
68 #ifndef NCURSES_ATTR_T
69 #define NCURSES_ATTR_T int
70 #endif
73 * Expands to 'const' if ncurses is configured using --enable-const. Note that
74 * doing so makes it incompatible with other implementations of X/Open Curses.
76 #undef NCURSES_CONST
77 #define NCURSES_CONST @NCURSES_CONST@
80 * The internal type used for color values
82 #undef NCURSES_COLOR_T
83 #define NCURSES_COLOR_T short
86 * The internal type used for window dimensions.
88 #undef NCURSES_SIZE_T
89 #define NCURSES_SIZE_T short
92 * NCURSES_CH_T is used in building the library, but not used otherwise in
93 * this header file, since that would make the normal/wide-character versions
94 * of the header incompatible.
96 #undef NCURSES_CH_T
97 #define NCURSES_CH_T @NCURSES_CH_T@
99 typedef unsigned @cf_cv_typeof_chtype@ chtype;
101 #include <stdio.h>
102 #include <unctrl.h>
103 #include <stdarg.h> /* we need va_list */
104 #ifdef _XOPEN_SOURCE_EXTENDED
105 #include <stddef.h> /* we want wchar_t */
106 #endif /* _XOPEN_SOURCE_EXTENDED */
108 /* XSI and SVr4 specify that curses implements 'bool'. However, C++ may also
109 * implement it. If so, we must use the C++ compiler's type to avoid conflict
110 * with other interfaces.
112 * A further complication is that <stdbool.h> may declare 'bool' to be a
113 * different type, such as an enum which is not necessarily compatible with
114 * C++. If we have <stdbool.h>, make 'bool' a macro, so users may #undef it.
115 * Otherwise, let it remain a typedef to avoid conflicts with other #define's.
116 * In either case, make a typedef for NCURSES_BOOL which can be used if needed
117 * from either C or C++.
120 #undef TRUE
121 #define TRUE 1
123 #undef FALSE
124 #define FALSE 0
126 typedef @cf_cv_type_of_bool@ NCURSES_BOOL;
128 #if @USE_CXX_BOOL@ /* __cplusplus, etc. */
130 /* use the C++ compiler's bool type */
131 #define NCURSES_BOOL bool
133 #else /* c89, c99, etc. */
135 #if @cf_cv_header_stdbool_h@
136 #include <stdbool.h>
137 /* use whatever the C compiler decides bool really is */
138 #define NCURSES_BOOL bool
139 #else
140 /* there is no predefined bool - use our own */
141 #undef bool
142 #define bool NCURSES_BOOL
143 #endif
145 #endif /* !__cplusplus, etc. */
147 #ifdef __cplusplus
148 extern "C" {
149 #endif
152 * XSI attributes. In the ncurses implementation, they are identical to the
153 * A_ attributes.
155 #define WA_ATTRIBUTES A_ATTRIBUTES
156 #define WA_NORMAL A_NORMAL
157 #define WA_STANDOUT A_STANDOUT
158 #define WA_UNDERLINE A_UNDERLINE
159 #define WA_REVERSE A_REVERSE
160 #define WA_BLINK A_BLINK
161 #define WA_DIM A_DIM
162 #define WA_BOLD A_BOLD
163 #define WA_ALTCHARSET A_ALTCHARSET
164 #define WA_INVIS A_INVIS
165 #define WA_PROTECT A_PROTECT
166 #define WA_HORIZONTAL A_HORIZONTAL
167 #define WA_LEFT A_LEFT
168 #define WA_LOW A_LOW
169 #define WA_RIGHT A_RIGHT
170 #define WA_TOP A_TOP
171 #define WA_VERTICAL A_VERTICAL
173 /* colors */
174 extern NCURSES_EXPORT_VAR(int) COLORS;
175 extern NCURSES_EXPORT_VAR(int) COLOR_PAIRS;
177 #define COLOR_BLACK 0
178 #define COLOR_RED 1
179 #define COLOR_GREEN 2
180 #define COLOR_YELLOW 3
181 #define COLOR_BLUE 4
182 #define COLOR_MAGENTA 5
183 #define COLOR_CYAN 6
184 #define COLOR_WHITE 7
186 /* line graphics */
188 #if @BROKEN_LINKER@
189 extern NCURSES_EXPORT_VAR(chtype*) _nc_acs_map(void);
190 #define acs_map (_nc_acs_map())
191 #else
192 extern NCURSES_EXPORT_VAR(chtype) acs_map[];
193 #endif
195 #define NCURSES_ACS(c) (acs_map[(unsigned char)c])
197 /* VT100 symbols begin here */
198 #define ACS_ULCORNER NCURSES_ACS('l') /* upper left corner */
199 #define ACS_LLCORNER NCURSES_ACS('m') /* lower left corner */
200 #define ACS_URCORNER NCURSES_ACS('k') /* upper right corner */
201 #define ACS_LRCORNER NCURSES_ACS('j') /* lower right corner */
202 #define ACS_LTEE NCURSES_ACS('t') /* tee pointing right */
203 #define ACS_RTEE NCURSES_ACS('u') /* tee pointing left */
204 #define ACS_BTEE NCURSES_ACS('v') /* tee pointing up */
205 #define ACS_TTEE NCURSES_ACS('w') /* tee pointing down */
206 #define ACS_HLINE NCURSES_ACS('q') /* horizontal line */
207 #define ACS_VLINE NCURSES_ACS('x') /* vertical line */
208 #define ACS_PLUS NCURSES_ACS('n') /* large plus or crossover */
209 #define ACS_S1 NCURSES_ACS('o') /* scan line 1 */
210 #define ACS_S9 NCURSES_ACS('s') /* scan line 9 */
211 #define ACS_DIAMOND NCURSES_ACS('`') /* diamond */
212 #define ACS_CKBOARD NCURSES_ACS('a') /* checker board (stipple) */
213 #define ACS_DEGREE NCURSES_ACS('f') /* degree symbol */
214 #define ACS_PLMINUS NCURSES_ACS('g') /* plus/minus */
215 #define ACS_BULLET NCURSES_ACS('~') /* bullet */
216 /* Teletype 5410v1 symbols begin here */
217 #define ACS_LARROW NCURSES_ACS(',') /* arrow pointing left */
218 #define ACS_RARROW NCURSES_ACS('+') /* arrow pointing right */
219 #define ACS_DARROW NCURSES_ACS('.') /* arrow pointing down */
220 #define ACS_UARROW NCURSES_ACS('-') /* arrow pointing up */
221 #define ACS_BOARD NCURSES_ACS('h') /* board of squares */
222 #define ACS_LANTERN NCURSES_ACS('i') /* lantern symbol */
223 #define ACS_BLOCK NCURSES_ACS('0') /* solid square block */
225 * These aren't documented, but a lot of System Vs have them anyway
226 * (you can spot pprryyzz{{||}} in a lot of AT&T terminfo strings).
227 * The ACS_names may not match AT&T's, our source didn't know them.
229 #define ACS_S3 NCURSES_ACS('p') /* scan line 3 */
230 #define ACS_S7 NCURSES_ACS('r') /* scan line 7 */
231 #define ACS_LEQUAL NCURSES_ACS('y') /* less/equal */
232 #define ACS_GEQUAL NCURSES_ACS('z') /* greater/equal */
233 #define ACS_PI NCURSES_ACS('{') /* Pi */
234 #define ACS_NEQUAL NCURSES_ACS('|') /* not equal */
235 #define ACS_STERLING NCURSES_ACS('}') /* UK pound sign */
238 * Line drawing ACS names are of the form ACS_trbl, where t is the top, r
239 * is the right, b is the bottom, and l is the left. t, r, b, and l might
240 * be B (blank), S (single), D (double), or T (thick). The subset defined
241 * here only uses B and S.
243 #define ACS_BSSB ACS_ULCORNER
244 #define ACS_SSBB ACS_LLCORNER
245 #define ACS_BBSS ACS_URCORNER
246 #define ACS_SBBS ACS_LRCORNER
247 #define ACS_SBSS ACS_RTEE
248 #define ACS_SSSB ACS_LTEE
249 #define ACS_SSBS ACS_BTEE
250 #define ACS_BSSS ACS_TTEE
251 #define ACS_BSBS ACS_HLINE
252 #define ACS_SBSB ACS_VLINE
253 #define ACS_SSSS ACS_PLUS
255 #undef ERR
256 #define ERR (-1)
258 #undef OK
259 #define OK (0)
261 /* values for the _flags member */
262 #define _SUBWIN 0x01 /* is this a sub-window? */
263 #define _ENDLINE 0x02 /* is the window flush right? */
264 #define _FULLWIN 0x04 /* is the window full-screen? */
265 #define _SCROLLWIN 0x08 /* bottom edge is at screen bottom? */
266 #define _ISPAD 0x10 /* is this window a pad? */
267 #define _HASMOVED 0x20 /* has cursor moved since last refresh? */
268 #define _WRAPPED 0x40 /* cursor was just wrappped */
271 * this value is used in the firstchar and lastchar fields to mark
272 * unchanged lines
274 #define _NOCHANGE -1
277 * this value is used in the oldindex field to mark lines created by insertions
278 * and scrolls.
280 #define _NEWINDEX -1
282 typedef struct screen SCREEN;
283 typedef struct _win_st WINDOW;
285 typedef chtype attr_t; /* ...must be at least as wide as chtype */
287 #ifdef _XOPEN_SOURCE_EXTENDED
289 #if @NCURSES_LIBUTF8@
290 #ifdef mblen /* libutf8.h defines it w/o undefining first */
291 #undef mblen
292 #endif
293 #include <libutf8.h>
294 #endif
296 #if @NEED_WCHAR_H@
297 #include <wchar.h> /* ...to get mbstate_t, etc. */
298 #endif
300 #if @NCURSES_WCHAR_T@
301 typedef unsigned short wchar_t@NCURSES_OK_WCHAR_T@;
302 #endif
304 #if @NCURSES_WINT_T@
305 typedef unsigned int wint_t@NCURSES_OK_WCHAR_T@;
306 #endif
308 #define CCHARW_MAX 5
309 typedef struct
311 attr_t attr;
312 wchar_t chars[CCHARW_MAX];
314 cchar_t;
316 #endif /* _XOPEN_SOURCE_EXTENDED */
318 struct ldat;
320 struct _win_st
322 NCURSES_SIZE_T _cury, _curx; /* current cursor position */
324 /* window location and size */
325 NCURSES_SIZE_T _maxy, _maxx; /* maximums of x and y, NOT window size */
326 NCURSES_SIZE_T _begy, _begx; /* screen coords of upper-left-hand corner */
328 short _flags; /* window state flags */
330 /* attribute tracking */
331 attr_t _attrs; /* current attribute for non-space character */
332 chtype _bkgd; /* current background char/attribute pair */
334 /* option values set by user */
335 bool _notimeout; /* no time out on function-key entry? */
336 bool _clear; /* consider all data in the window invalid? */
337 bool _leaveok; /* OK to not reset cursor on exit? */
338 bool _scroll; /* OK to scroll this window? */
339 bool _idlok; /* OK to use insert/delete line? */
340 bool _idcok; /* OK to use insert/delete char? */
341 bool _immed; /* window in immed mode? (not yet used) */
342 bool _sync; /* window in sync mode? */
343 bool _use_keypad; /* process function keys into KEY_ symbols? */
344 int _delay; /* 0 = nodelay, <0 = blocking, >0 = delay */
346 struct ldat *_line; /* the actual line data */
348 /* global screen state */
349 NCURSES_SIZE_T _regtop; /* top line of scrolling region */
350 NCURSES_SIZE_T _regbottom; /* bottom line of scrolling region */
352 /* these are used only if this is a sub-window */
353 int _parx; /* x coordinate of this window in parent */
354 int _pary; /* y coordinate of this window in parent */
355 WINDOW *_parent; /* pointer to parent if a sub-window */
357 /* these are used only if this is a pad */
358 struct pdat
360 NCURSES_SIZE_T _pad_y, _pad_x;
361 NCURSES_SIZE_T _pad_top, _pad_left;
362 NCURSES_SIZE_T _pad_bottom, _pad_right;
363 } _pad;
365 NCURSES_SIZE_T _yoffset; /* real begy is _begy + _yoffset */
367 #ifdef _XOPEN_SOURCE_EXTENDED
368 cchar_t _bkgrnd; /* current background char/attribute pair */
369 #endif
372 extern NCURSES_EXPORT_VAR(WINDOW *) stdscr;
373 extern NCURSES_EXPORT_VAR(WINDOW *) curscr;
374 extern NCURSES_EXPORT_VAR(WINDOW *) newscr;
376 extern NCURSES_EXPORT_VAR(int) LINES;
377 extern NCURSES_EXPORT_VAR(int) COLS;
378 extern NCURSES_EXPORT_VAR(int) TABSIZE;
381 * This global was an undocumented feature under AIX curses.
383 extern NCURSES_EXPORT_VAR(int) ESCDELAY; /* ESC expire time in milliseconds */
385 extern NCURSES_EXPORT_VAR(char) ttytype[]; /* needed for backward compatibility */
388 * These functions are extensions - not in XSI Curses.
390 #if @NCURSES_EXT_FUNCS@
391 extern NCURSES_EXPORT(bool) is_term_resized (int, int);
392 extern NCURSES_EXPORT(char *) keybound (int, int);
393 extern NCURSES_EXPORT(const char *) curses_version (void);
394 extern NCURSES_EXPORT(int) assume_default_colors (int, int);
395 extern NCURSES_EXPORT(int) define_key (const char *, int);
396 extern NCURSES_EXPORT(int) key_defined (const char *);
397 extern NCURSES_EXPORT(int) keyok (int, bool);
398 extern NCURSES_EXPORT(int) resize_term (int, int);
399 extern NCURSES_EXPORT(int) resizeterm (int, int);
400 extern NCURSES_EXPORT(int) use_default_colors (void);
401 extern NCURSES_EXPORT(int) use_extended_names (bool);
402 extern NCURSES_EXPORT(int) wresize (WINDOW *, int, int);
403 #else
404 #define curses_version() NCURSES_VERSION
405 #endif
408 * This is an extension to support events...
410 #if @NCURSES_EXT_FUNCS@
411 #ifdef NCURSES_WGETCH_EVENTS
412 #if !defined(__BEOS__) /* Fix _nc_timed_wait() on BEOS... */
413 # define NCURSES_EVENT_VERSION 1
414 #endif /* !defined(__BEOS__) */
417 * Bits to set in _nc_event.data.flags
419 # define _NC_EVENT_TIMEOUT_MSEC 1
420 # define _NC_EVENT_FILE 2
421 # define _NC_EVENT_FILE_READABLE 2
422 # if 0 /* Not supported yet... */
423 # define _NC_EVENT_FILE_WRITABLE 4
424 # define _NC_EVENT_FILE_EXCEPTION 8
425 # endif
427 typedef struct
429 int type;
430 union
432 long timeout_msec; /* _NC_EVENT_TIMEOUT_MSEC */
433 struct
435 unsigned int flags;
436 int fd;
437 unsigned int result;
438 } fev; /* _NC_EVENT_FILE */
439 } data;
440 } _nc_event;
442 typedef struct
444 int count;
445 int result_flags; /* _NC_EVENT_TIMEOUT_MSEC or _NC_EVENT_FILE_READABLE */
446 _nc_event *events[1];
447 } _nc_eventlist;
449 extern NCURSES_EXPORT(int) wgetch_events(WINDOW *, _nc_eventlist *); /* experimental */
450 extern NCURSES_EXPORT(int) wgetnstr_events(WINDOW *,char *,int,_nc_eventlist *);/* experimental */
452 #endif /* NCURSES_WGETCH_EVENTS */
453 #endif /* NCURSES_EXT_FUNCS */
456 * GCC (and some other compilers) define '__attribute__'; we're using this
457 * macro to alert the compiler to flag inconsistencies in printf/scanf-like
458 * function calls. Just in case '__attribute__' isn't defined, make a dummy.
459 * Old versions of G++ do not accept it anyway, at least not consistently with
460 * GCC.
462 #if !(defined(__GNUC__) || defined(__GNUG__) || defined(__attribute__))
463 #define __attribute__(p) /* nothing */
464 #endif
467 * We cannot define these in ncurses_cfg.h, since they require parameters to be
468 * passed (that's non-portable).
470 #ifndef GCC_PRINTFLIKE
471 #if defined(GCC_PRINTF) && !defined(printf)
472 #define GCC_PRINTFLIKE(fmt,var) __attribute__((format(printf,fmt,var)))
473 #else
474 #define GCC_PRINTFLIKE(fmt,var) /*nothing*/
475 #endif
476 #endif
478 #ifndef GCC_SCANFLIKE
479 #if defined(GCC_SCANF) && !defined(scanf)
480 #define GCC_SCANFLIKE(fmt,var) __attribute__((format(scanf,fmt,var)))
481 #else
482 #define GCC_SCANFLIKE(fmt,var) /*nothing*/
483 #endif
484 #endif
486 #ifndef GCC_NORETURN
487 #define GCC_NORETURN /* nothing */
488 #endif
490 #ifndef GCC_UNUSED
491 #define GCC_UNUSED /* nothing */
492 #endif
495 * Function prototypes. This is the complete XSI Curses list of required
496 * functions. Those marked `generated' will have sources generated from the
497 * macro definitions later in this file, in order to satisfy XPG4.2
498 * requirements.
501 extern NCURSES_EXPORT(int) addch (const chtype); /* generated */
502 extern NCURSES_EXPORT(int) addchnstr (const chtype *, int); /* generated */
503 extern NCURSES_EXPORT(int) addchstr (const chtype *); /* generated */
504 extern NCURSES_EXPORT(int) addnstr (const char *, int); /* generated */
505 extern NCURSES_EXPORT(int) addstr (const char *); /* generated */
506 extern NCURSES_EXPORT(int) attroff (NCURSES_ATTR_T); /* generated */
507 extern NCURSES_EXPORT(int) attron (NCURSES_ATTR_T); /* generated */
508 extern NCURSES_EXPORT(int) attrset (NCURSES_ATTR_T); /* generated */
509 extern NCURSES_EXPORT(int) attr_get (attr_t *, short *, void *); /* generated */
510 extern NCURSES_EXPORT(int) attr_off (attr_t, void *); /* generated */
511 extern NCURSES_EXPORT(int) attr_on (attr_t, void *); /* generated */
512 extern NCURSES_EXPORT(int) attr_set (attr_t, short, void *); /* generated */
513 extern NCURSES_EXPORT(int) baudrate (void); /* implemented */
514 extern NCURSES_EXPORT(int) beep (void); /* implemented */
515 extern NCURSES_EXPORT(int) bkgd (chtype); /* generated */
516 extern NCURSES_EXPORT(void) bkgdset (chtype); /* generated */
517 extern NCURSES_EXPORT(int) border (chtype,chtype,chtype,chtype,chtype,chtype,chtype,chtype); /* generated */
518 extern NCURSES_EXPORT(int) box (WINDOW *, chtype, chtype); /* generated */
519 extern NCURSES_EXPORT(bool) can_change_color (void); /* implemented */
520 extern NCURSES_EXPORT(int) cbreak (void); /* implemented */
521 extern NCURSES_EXPORT(int) chgat (int, attr_t, short, const void *); /* generated */
522 extern NCURSES_EXPORT(int) clear (void); /* generated */
523 extern NCURSES_EXPORT(int) clearok (WINDOW *,bool); /* implemented */
524 extern NCURSES_EXPORT(int) clrtobot (void); /* generated */
525 extern NCURSES_EXPORT(int) clrtoeol (void); /* generated */
526 extern NCURSES_EXPORT(int) color_content (short,short*,short*,short*); /* implemented */
527 extern NCURSES_EXPORT(int) color_set (short,void*); /* generated */
528 extern NCURSES_EXPORT(int) COLOR_PAIR (int); /* generated */
529 extern NCURSES_EXPORT(int) copywin (const WINDOW*,WINDOW*,int,int,int,int,int,int,int); /* implemented */
530 extern NCURSES_EXPORT(int) curs_set (int); /* implemented */
531 extern NCURSES_EXPORT(int) def_prog_mode (void); /* implemented */
532 extern NCURSES_EXPORT(int) def_shell_mode (void); /* implemented */
533 extern NCURSES_EXPORT(int) delay_output (int); /* implemented */
534 extern NCURSES_EXPORT(int) delch (void); /* generated */
535 extern NCURSES_EXPORT(void) delscreen (SCREEN *); /* implemented */
536 extern NCURSES_EXPORT(int) delwin (WINDOW *); /* implemented */
537 extern NCURSES_EXPORT(int) deleteln (void); /* generated */
538 extern NCURSES_EXPORT(WINDOW *) derwin (WINDOW *,int,int,int,int); /* implemented */
539 extern NCURSES_EXPORT(int) doupdate (void); /* implemented */
540 extern NCURSES_EXPORT(WINDOW *) dupwin (WINDOW *); /* implemented */
541 extern NCURSES_EXPORT(int) echo (void); /* implemented */
542 extern NCURSES_EXPORT(int) echochar (const chtype); /* generated */
543 extern NCURSES_EXPORT(int) erase (void); /* generated */
544 extern NCURSES_EXPORT(int) endwin (void); /* implemented */
545 extern NCURSES_EXPORT(char) erasechar (void); /* implemented */
546 extern NCURSES_EXPORT(void) filter (void); /* implemented */
547 extern NCURSES_EXPORT(int) flash (void); /* implemented */
548 extern NCURSES_EXPORT(int) flushinp (void); /* implemented */
549 extern NCURSES_EXPORT(chtype) getbkgd (WINDOW *); /* generated */
550 extern NCURSES_EXPORT(int) getch (void); /* generated */
551 extern NCURSES_EXPORT(int) getnstr (char *, int); /* generated */
552 extern NCURSES_EXPORT(int) getstr (char *); /* generated */
553 extern NCURSES_EXPORT(WINDOW *) getwin (FILE *); /* implemented */
554 extern NCURSES_EXPORT(int) halfdelay (int); /* implemented */
555 extern NCURSES_EXPORT(bool) has_colors (void); /* implemented */
556 extern NCURSES_EXPORT(bool) has_ic (void); /* implemented */
557 extern NCURSES_EXPORT(bool) has_il (void); /* implemented */
558 extern NCURSES_EXPORT(int) hline (chtype, int); /* generated */
559 extern NCURSES_EXPORT(void) idcok (WINDOW *, bool); /* implemented */
560 extern NCURSES_EXPORT(int) idlok (WINDOW *, bool); /* implemented */
561 extern NCURSES_EXPORT(void) immedok (WINDOW *, bool); /* implemented */
562 extern NCURSES_EXPORT(chtype) inch (void); /* generated */
563 extern NCURSES_EXPORT(int) inchnstr (chtype *, int); /* generated */
564 extern NCURSES_EXPORT(int) inchstr (chtype *); /* generated */
565 extern NCURSES_EXPORT(WINDOW *) initscr (void); /* implemented */
566 extern NCURSES_EXPORT(int) init_color (short,short,short,short); /* implemented */
567 extern NCURSES_EXPORT(int) init_pair (short,short,short); /* implemented */
568 extern NCURSES_EXPORT(int) innstr (char *, int); /* generated */
569 extern NCURSES_EXPORT(int) insch (chtype); /* generated */
570 extern NCURSES_EXPORT(int) insdelln (int); /* generated */
571 extern NCURSES_EXPORT(int) insertln (void); /* generated */
572 extern NCURSES_EXPORT(int) insnstr (const char *, int); /* generated */
573 extern NCURSES_EXPORT(int) insstr (const char *); /* generated */
574 extern NCURSES_EXPORT(int) instr (char *); /* generated */
575 extern NCURSES_EXPORT(int) intrflush (WINDOW *,bool); /* implemented */
576 extern NCURSES_EXPORT(bool) isendwin (void); /* implemented */
577 extern NCURSES_EXPORT(bool) is_linetouched (WINDOW *,int); /* implemented */
578 extern NCURSES_EXPORT(bool) is_wintouched (WINDOW *); /* implemented */
579 extern NCURSES_EXPORT(NCURSES_CONST char *) keyname (int); /* implemented */
580 extern NCURSES_EXPORT(int) keypad (WINDOW *,bool); /* implemented */
581 extern NCURSES_EXPORT(char) killchar (void); /* implemented */
582 extern NCURSES_EXPORT(int) leaveok (WINDOW *,bool); /* implemented */
583 extern NCURSES_EXPORT(char *) longname (void); /* implemented */
584 extern NCURSES_EXPORT(int) meta (WINDOW *,bool); /* implemented */
585 extern NCURSES_EXPORT(int) move (int, int); /* generated */
586 extern NCURSES_EXPORT(int) mvaddch (int, int, const chtype); /* generated */
587 extern NCURSES_EXPORT(int) mvaddchnstr (int, int, const chtype *, int); /* generated */
588 extern NCURSES_EXPORT(int) mvaddchstr (int, int, const chtype *); /* generated */
589 extern NCURSES_EXPORT(int) mvaddnstr (int, int, const char *, int); /* generated */
590 extern NCURSES_EXPORT(int) mvaddstr (int, int, const char *); /* generated */
591 extern NCURSES_EXPORT(int) mvchgat (int, int, int, attr_t, short, const void *); /* generated */
592 extern NCURSES_EXPORT(int) mvcur (int,int,int,int); /* implemented */
593 extern NCURSES_EXPORT(int) mvdelch (int, int); /* generated */
594 extern NCURSES_EXPORT(int) mvderwin (WINDOW *, int, int); /* implemented */
595 extern NCURSES_EXPORT(int) mvgetch (int, int); /* generated */
596 extern NCURSES_EXPORT(int) mvgetnstr (int, int, char *, int); /* generated */
597 extern NCURSES_EXPORT(int) mvgetstr (int, int, char *); /* generated */
598 extern NCURSES_EXPORT(int) mvhline (int, int, chtype, int); /* generated */
599 extern NCURSES_EXPORT(chtype) mvinch (int, int); /* generated */
600 extern NCURSES_EXPORT(int) mvinchnstr (int, int, chtype *, int); /* generated */
601 extern NCURSES_EXPORT(int) mvinchstr (int, int, chtype *); /* generated */
602 extern NCURSES_EXPORT(int) mvinnstr (int, int, char *, int); /* generated */
603 extern NCURSES_EXPORT(int) mvinsch (int, int, chtype); /* generated */
604 extern NCURSES_EXPORT(int) mvinsnstr (int, int, const char *, int); /* generated */
605 extern NCURSES_EXPORT(int) mvinsstr (int, int, const char *); /* generated */
606 extern NCURSES_EXPORT(int) mvinstr (int, int, char *); /* generated */
607 extern NCURSES_EXPORT(int) mvprintw (int,int, const char *,...) /* implemented */
608 GCC_PRINTFLIKE(3,4);
609 extern NCURSES_EXPORT(int) mvscanw (int,int, NCURSES_CONST char *,...) /* implemented */
610 GCC_SCANFLIKE(3,4);
611 extern NCURSES_EXPORT(int) mvvline (int, int, chtype, int); /* generated */
612 extern NCURSES_EXPORT(int) mvwaddch (WINDOW *, int, int, const chtype); /* generated */
613 extern NCURSES_EXPORT(int) mvwaddchnstr (WINDOW *, int, int, const chtype *, int);/* generated */
614 extern NCURSES_EXPORT(int) mvwaddchstr (WINDOW *, int, int, const chtype *); /* generated */
615 extern NCURSES_EXPORT(int) mvwaddnstr (WINDOW *, int, int, const char *, int); /* generated */
616 extern NCURSES_EXPORT(int) mvwaddstr (WINDOW *, int, int, const char *); /* generated */
617 extern NCURSES_EXPORT(int) mvwchgat (WINDOW *, int, int, int, attr_t, short, const void *);/* generated */
618 extern NCURSES_EXPORT(int) mvwdelch (WINDOW *, int, int); /* generated */
619 extern NCURSES_EXPORT(int) mvwgetch (WINDOW *, int, int); /* generated */
620 extern NCURSES_EXPORT(int) mvwgetnstr (WINDOW *, int, int, char *, int); /* generated */
621 extern NCURSES_EXPORT(int) mvwgetstr (WINDOW *, int, int, char *); /* generated */
622 extern NCURSES_EXPORT(int) mvwhline (WINDOW *, int, int, chtype, int); /* generated */
623 extern NCURSES_EXPORT(int) mvwin (WINDOW *,int,int); /* implemented */
624 extern NCURSES_EXPORT(chtype) mvwinch (WINDOW *, int, int); /* generated */
625 extern NCURSES_EXPORT(int) mvwinchnstr (WINDOW *, int, int, chtype *, int); /* generated */
626 extern NCURSES_EXPORT(int) mvwinchstr (WINDOW *, int, int, chtype *); /* generated */
627 extern NCURSES_EXPORT(int) mvwinnstr (WINDOW *, int, int, char *, int); /* generated */
628 extern NCURSES_EXPORT(int) mvwinsch (WINDOW *, int, int, chtype); /* generated */
629 extern NCURSES_EXPORT(int) mvwinsnstr (WINDOW *, int, int, const char *, int); /* generated */
630 extern NCURSES_EXPORT(int) mvwinsstr (WINDOW *, int, int, const char *); /* generated */
631 extern NCURSES_EXPORT(int) mvwinstr (WINDOW *, int, int, char *); /* generated */
632 extern NCURSES_EXPORT(int) mvwprintw (WINDOW*,int,int, const char *,...) /* implemented */
633 GCC_PRINTFLIKE(4,5);
634 extern NCURSES_EXPORT(int) mvwscanw (WINDOW *,int,int, NCURSES_CONST char *,...) /* implemented */
635 GCC_SCANFLIKE(4,5);
636 extern NCURSES_EXPORT(int) mvwvline (WINDOW *,int, int, chtype, int); /* generated */
637 extern NCURSES_EXPORT(int) napms (int); /* implemented */
638 extern NCURSES_EXPORT(WINDOW *) newpad (int,int); /* implemented */
639 extern NCURSES_EXPORT(SCREEN *) newterm (NCURSES_CONST char *,FILE *,FILE *); /* implemented */
640 extern NCURSES_EXPORT(WINDOW *) newwin (int,int,int,int); /* implemented */
641 extern NCURSES_EXPORT(int) nl (void); /* implemented */
642 extern NCURSES_EXPORT(int) nocbreak (void); /* implemented */
643 extern NCURSES_EXPORT(int) nodelay (WINDOW *,bool); /* implemented */
644 extern NCURSES_EXPORT(int) noecho (void); /* implemented */
645 extern NCURSES_EXPORT(int) nonl (void); /* implemented */
646 extern NCURSES_EXPORT(void) noqiflush (void); /* implemented */
647 extern NCURSES_EXPORT(int) noraw (void); /* implemented */
648 extern NCURSES_EXPORT(int) notimeout (WINDOW *,bool); /* implemented */
649 extern NCURSES_EXPORT(int) overlay (const WINDOW*,WINDOW *); /* implemented */
650 extern NCURSES_EXPORT(int) overwrite (const WINDOW*,WINDOW *); /* implemented */
651 extern NCURSES_EXPORT(int) pair_content (short,short*,short*); /* implemented */
652 extern NCURSES_EXPORT(int) PAIR_NUMBER (int); /* generated */
653 extern NCURSES_EXPORT(int) pechochar (WINDOW *, const chtype); /* implemented */
654 extern NCURSES_EXPORT(int) pnoutrefresh (WINDOW*,int,int,int,int,int,int);/* implemented */
655 extern NCURSES_EXPORT(int) prefresh (WINDOW *,int,int,int,int,int,int); /* implemented */
656 extern NCURSES_EXPORT(int) printw (const char *,...) /* implemented */
657 GCC_PRINTFLIKE(1,2);
658 extern NCURSES_EXPORT(int) putp (const char *); /* implemented */
659 extern NCURSES_EXPORT(int) putwin (WINDOW *, FILE *); /* implemented */
660 extern NCURSES_EXPORT(void) qiflush (void); /* implemented */
661 extern NCURSES_EXPORT(int) raw (void); /* implemented */
662 extern NCURSES_EXPORT(int) redrawwin (WINDOW *); /* generated */
663 extern NCURSES_EXPORT(int) refresh (void); /* generated */
664 extern NCURSES_EXPORT(int) resetty (void); /* implemented */
665 extern NCURSES_EXPORT(int) reset_prog_mode (void); /* implemented */
666 extern NCURSES_EXPORT(int) reset_shell_mode (void); /* implemented */
667 extern NCURSES_EXPORT(int) ripoffline (int, int (*)(WINDOW *, int)); /* implemented */
668 extern NCURSES_EXPORT(int) savetty (void); /* implemented */
669 extern NCURSES_EXPORT(int) scanw (NCURSES_CONST char *,...) /* implemented */
670 GCC_SCANFLIKE(1,2);
671 extern NCURSES_EXPORT(int) scr_dump (const char *); /* implemented */
672 extern NCURSES_EXPORT(int) scr_init (const char *); /* implemented */
673 extern NCURSES_EXPORT(int) scrl (int); /* generated */
674 extern NCURSES_EXPORT(int) scroll (WINDOW *); /* generated */
675 extern NCURSES_EXPORT(int) scrollok (WINDOW *,bool); /* implemented */
676 extern NCURSES_EXPORT(int) scr_restore (const char *); /* implemented */
677 extern NCURSES_EXPORT(int) scr_set (const char *); /* implemented */
678 extern NCURSES_EXPORT(int) setscrreg (int,int); /* generated */
679 extern NCURSES_EXPORT(SCREEN *) set_term (SCREEN *); /* implemented */
680 extern NCURSES_EXPORT(int) slk_attroff (const chtype); /* implemented */
681 extern NCURSES_EXPORT(int) slk_attr_off (const attr_t, void *); /* generated:WIDEC */
682 extern NCURSES_EXPORT(int) slk_attron (const chtype); /* implemented */
683 extern NCURSES_EXPORT(int) slk_attr_on (attr_t,void*); /* generated:WIDEC */
684 extern NCURSES_EXPORT(int) slk_attrset (const chtype); /* implemented */
685 extern NCURSES_EXPORT(attr_t) slk_attr (void); /* implemented */
686 extern NCURSES_EXPORT(int) slk_attr_set (const attr_t,short,void*); /* implemented */
687 extern NCURSES_EXPORT(int) slk_clear (void); /* implemented */
688 extern NCURSES_EXPORT(int) slk_color (short); /* implemented */
689 extern NCURSES_EXPORT(int) slk_init (int); /* implemented */
690 extern NCURSES_EXPORT(char *) slk_label (int); /* implemented */
691 extern NCURSES_EXPORT(int) slk_noutrefresh (void); /* implemented */
692 extern NCURSES_EXPORT(int) slk_refresh (void); /* implemented */
693 extern NCURSES_EXPORT(int) slk_restore (void); /* implemented */
694 extern NCURSES_EXPORT(int) slk_set (int,const char *,int); /* implemented */
695 extern NCURSES_EXPORT(int) slk_touch (void); /* implemented */
696 extern NCURSES_EXPORT(int) standout (void); /* generated */
697 extern NCURSES_EXPORT(int) standend (void); /* generated */
698 extern NCURSES_EXPORT(int) start_color (void); /* implemented */
699 extern NCURSES_EXPORT(WINDOW *) subpad (WINDOW *, int, int, int, int); /* implemented */
700 extern NCURSES_EXPORT(WINDOW *) subwin (WINDOW *,int,int,int,int); /* implemented */
701 extern NCURSES_EXPORT(int) syncok (WINDOW *, bool); /* implemented */
702 extern NCURSES_EXPORT(chtype) termattrs (void); /* implemented */
703 extern NCURSES_EXPORT(char *) termname (void); /* implemented */
704 extern NCURSES_EXPORT(int) tigetflag (NCURSES_CONST char *); /* implemented */
705 extern NCURSES_EXPORT(int) tigetnum (NCURSES_CONST char *); /* implemented */
706 extern NCURSES_EXPORT(char *) tigetstr (NCURSES_CONST char *); /* implemented */
707 extern NCURSES_EXPORT(void) timeout (int); /* generated */
708 extern NCURSES_EXPORT(int) touchline (WINDOW *, int, int); /* generated */
709 extern NCURSES_EXPORT(int) touchwin (WINDOW *); /* generated */
710 extern NCURSES_EXPORT(char *) tparm (NCURSES_CONST char *, ...); /* implemented */
711 extern NCURSES_EXPORT(int) typeahead (int); /* implemented */
712 extern NCURSES_EXPORT(int) ungetch (int); /* implemented */
713 extern NCURSES_EXPORT(int) untouchwin (WINDOW *); /* generated */
714 extern NCURSES_EXPORT(void) use_env (bool); /* implemented */
715 extern NCURSES_EXPORT(int) vidattr (chtype); /* implemented */
716 extern NCURSES_EXPORT(int) vidputs (chtype, int (*)(int)); /* implemented */
717 extern NCURSES_EXPORT(int) vline (chtype, int); /* generated */
718 extern NCURSES_EXPORT(int) vwprintw (WINDOW *, const char *,va_list); /* implemented */
719 extern NCURSES_EXPORT(int) vw_printw (WINDOW *, const char *,va_list); /* generated */
720 extern NCURSES_EXPORT(int) vwscanw (WINDOW *, NCURSES_CONST char *,va_list); /* implemented */
721 extern NCURSES_EXPORT(int) vw_scanw (WINDOW *, NCURSES_CONST char *,va_list); /* generated */
722 extern NCURSES_EXPORT(int) waddch (WINDOW *, const chtype); /* implemented */
723 extern NCURSES_EXPORT(int) waddchnstr (WINDOW *,const chtype *,int); /* implemented */
724 extern NCURSES_EXPORT(int) waddchstr (WINDOW *,const chtype *); /* generated */
725 extern NCURSES_EXPORT(int) waddnstr (WINDOW *,const char *,int); /* implemented */
726 extern NCURSES_EXPORT(int) waddstr (WINDOW *,const char *); /* generated */
727 extern NCURSES_EXPORT(int) wattron (WINDOW *, int); /* generated */
728 extern NCURSES_EXPORT(int) wattroff (WINDOW *, int); /* generated */
729 extern NCURSES_EXPORT(int) wattrset (WINDOW *, int); /* generated */
730 extern NCURSES_EXPORT(int) wattr_get (WINDOW *, attr_t *, short *, void *); /* generated */
731 extern NCURSES_EXPORT(int) wattr_on (WINDOW *, attr_t, void *); /* implemented */
732 extern NCURSES_EXPORT(int) wattr_off (WINDOW *, attr_t, void *); /* implemented */
733 extern NCURSES_EXPORT(int) wattr_set (WINDOW *, attr_t, short, void *); /* generated */
734 extern NCURSES_EXPORT(int) wbkgd (WINDOW *, chtype); /* implemented */
735 extern NCURSES_EXPORT(void) wbkgdset (WINDOW *,chtype); /* implemented */
736 extern NCURSES_EXPORT(int) wborder (WINDOW *,chtype,chtype,chtype,chtype,chtype,chtype,chtype,chtype); /* implemented */
737 extern NCURSES_EXPORT(int) wchgat (WINDOW *, int, attr_t, short, const void *);/* implemented */
738 extern NCURSES_EXPORT(int) wclear (WINDOW *); /* implemented */
739 extern NCURSES_EXPORT(int) wclrtobot (WINDOW *); /* implemented */
740 extern NCURSES_EXPORT(int) wclrtoeol (WINDOW *); /* implemented */
741 extern NCURSES_EXPORT(int) wcolor_set (WINDOW*,short,void*); /* implemented */
742 extern NCURSES_EXPORT(void) wcursyncup (WINDOW *); /* implemented */
743 extern NCURSES_EXPORT(int) wdelch (WINDOW *); /* implemented */
744 extern NCURSES_EXPORT(int) wdeleteln (WINDOW *); /* generated */
745 extern NCURSES_EXPORT(int) wechochar (WINDOW *, const chtype); /* implemented */
746 extern NCURSES_EXPORT(int) werase (WINDOW *); /* implemented */
747 extern NCURSES_EXPORT(int) wgetch (WINDOW *); /* implemented */
748 extern NCURSES_EXPORT(int) wgetnstr (WINDOW *,char *,int); /* implemented */
749 extern NCURSES_EXPORT(int) wgetstr (WINDOW *, char *); /* generated */
750 extern NCURSES_EXPORT(int) whline (WINDOW *, chtype, int); /* implemented */
751 extern NCURSES_EXPORT(chtype) winch (WINDOW *); /* implemented */
752 extern NCURSES_EXPORT(int) winchnstr (WINDOW *, chtype *, int); /* implemented */
753 extern NCURSES_EXPORT(int) winchstr (WINDOW *, chtype *); /* generated */
754 extern NCURSES_EXPORT(int) winnstr (WINDOW *, char *, int); /* implemented */
755 extern NCURSES_EXPORT(int) winsch (WINDOW *, chtype); /* implemented */
756 extern NCURSES_EXPORT(int) winsdelln (WINDOW *,int); /* implemented */
757 extern NCURSES_EXPORT(int) winsertln (WINDOW *); /* generated */
758 extern NCURSES_EXPORT(int) winsnstr (WINDOW *, const char *,int); /* implemented */
759 extern NCURSES_EXPORT(int) winsstr (WINDOW *, const char *); /* generated */
760 extern NCURSES_EXPORT(int) winstr (WINDOW *, char *); /* generated */
761 extern NCURSES_EXPORT(int) wmove (WINDOW *,int,int); /* implemented */
762 extern NCURSES_EXPORT(int) wnoutrefresh (WINDOW *); /* implemented */
763 extern NCURSES_EXPORT(int) wprintw (WINDOW *, const char *,...) /* implemented */
764 GCC_PRINTFLIKE(2,3);
765 extern NCURSES_EXPORT(int) wredrawln (WINDOW *,int,int); /* implemented */
766 extern NCURSES_EXPORT(int) wrefresh (WINDOW *); /* implemented */
767 extern NCURSES_EXPORT(int) wscanw (WINDOW *, NCURSES_CONST char *,...) /* implemented */
768 GCC_SCANFLIKE(2,3);
769 extern NCURSES_EXPORT(int) wscrl (WINDOW *,int); /* implemented */
770 extern NCURSES_EXPORT(int) wsetscrreg (WINDOW *,int,int); /* implemented */
771 extern NCURSES_EXPORT(int) wstandout (WINDOW *); /* generated */
772 extern NCURSES_EXPORT(int) wstandend (WINDOW *); /* generated */
773 extern NCURSES_EXPORT(void) wsyncdown (WINDOW *); /* implemented */
774 extern NCURSES_EXPORT(void) wsyncup (WINDOW *); /* implemented */
775 extern NCURSES_EXPORT(void) wtimeout (WINDOW *,int); /* implemented */
776 extern NCURSES_EXPORT(int) wtouchln (WINDOW *,int,int,int); /* implemented */
777 extern NCURSES_EXPORT(int) wvline (WINDOW *,chtype,int); /* implemented */
780 * vid_attr() was implemented originally based on the draft of XSI curses.
782 #ifndef _XOPEN_SOURCE_EXTENDED
783 #define vid_attr(a,pair,opts) vidattr(a)
784 #endif
786 /* attributes */
788 #define NCURSES_ATTR_SHIFT 8
789 #define NCURSES_BITS(mask,shift) ((mask) << ((shift) + NCURSES_ATTR_SHIFT))
791 #define A_NORMAL 0L
792 #define A_ATTRIBUTES NCURSES_BITS(~(@cf_cv_1UL@ - @cf_cv_1UL@),0)
793 #define A_CHARTEXT (NCURSES_BITS(@cf_cv_1UL@,0) - @cf_cv_1UL@)
794 #define A_COLOR NCURSES_BITS(((@cf_cv_1UL@) << 8) - @cf_cv_1UL@,0)
795 #define A_STANDOUT NCURSES_BITS(@cf_cv_1UL@,8)
796 #define A_UNDERLINE NCURSES_BITS(@cf_cv_1UL@,9)
797 #define A_REVERSE NCURSES_BITS(@cf_cv_1UL@,10)
798 #define A_BLINK NCURSES_BITS(@cf_cv_1UL@,11)
799 #define A_DIM NCURSES_BITS(@cf_cv_1UL@,12)
800 #define A_BOLD NCURSES_BITS(@cf_cv_1UL@,13)
801 #define A_ALTCHARSET NCURSES_BITS(@cf_cv_1UL@,14)
802 #define A_INVIS NCURSES_BITS(@cf_cv_1UL@,15)
803 #define A_PROTECT NCURSES_BITS(@cf_cv_1UL@,16)
804 #define A_HORIZONTAL NCURSES_BITS(@cf_cv_1UL@,17)
805 #define A_LEFT NCURSES_BITS(@cf_cv_1UL@,18)
806 #define A_LOW NCURSES_BITS(@cf_cv_1UL@,19)
807 #define A_RIGHT NCURSES_BITS(@cf_cv_1UL@,20)
808 #define A_TOP NCURSES_BITS(@cf_cv_1UL@,21)
809 #define A_VERTICAL NCURSES_BITS(@cf_cv_1UL@,22)
811 #define COLOR_PAIR(n) NCURSES_BITS(n, 0)
812 #define PAIR_NUMBER(a) ((int)(((a) & A_COLOR) >> NCURSES_ATTR_SHIFT))
815 * pseudo functions
817 #define wgetstr(w, s) wgetnstr(w, s, -1)
818 #define getnstr(s, n) wgetnstr(stdscr, s, n)
820 #define setterm(term) setupterm(term, 1, (int *)0)
822 #define fixterm() reset_prog_mode()
823 #define resetterm() reset_shell_mode()
824 #define saveterm() def_prog_mode()
825 #define crmode() cbreak()
826 #define nocrmode() nocbreak()
827 #define gettmode()
829 #define getyx(win,y,x) (y = getcury(win), x = getcurx(win))
830 #define getbegyx(win,y,x) (y = getbegy(win), x = getbegx(win))
831 #define getmaxyx(win,y,x) (y = getmaxy(win), x = getmaxx(win))
832 #define getparyx(win,y,x) (y = getpary(win), x = getparx(win))
834 #define getsyx(y,x) do { if(newscr->_leaveok) (y)=(x)=-1; \
835 else getyx(newscr,(y),(x)); \
836 } while(0)
837 #define setsyx(y,x) do { if((y)==-1 && (x)==-1) newscr->_leaveok=TRUE; \
838 else {newscr->_leaveok=FALSE;wmove(newscr,(y),(x));} \
839 } while(0)
841 /* It seems older SYSV curses versions define these */
842 #define getattrs(win) ((win)?(win)->_attrs:A_NORMAL)
843 #define getcurx(win) ((win)?(win)->_curx:ERR)
844 #define getcury(win) ((win)?(win)->_cury:ERR)
845 #define getbegx(win) ((win)?(win)->_begx:ERR)
846 #define getbegy(win) ((win)?(win)->_begy:ERR)
847 #define getmaxx(win) ((win)?((win)->_maxx + 1):ERR)
848 #define getmaxy(win) ((win)?((win)->_maxy + 1):ERR)
849 #define getparx(win) ((win)?(win)->_parx:ERR)
850 #define getpary(win) ((win)?(win)->_pary:ERR)
852 #define wstandout(win) (wattrset(win,A_STANDOUT))
853 #define wstandend(win) (wattrset(win,A_NORMAL))
854 #define wattr_set(win,a,p,opts) ((win)->_attrs = (((a) & ~A_COLOR) | COLOR_PAIR(p)), OK)
856 #define wattron(win,at) wattr_on(win, (attr_t) at, (void *)0)
857 #define wattroff(win,at) wattr_off(win, (attr_t) at, (void *)0)
858 #define wattrset(win,at) ((win)->_attrs = (at))
860 #define scroll(win) wscrl(win,1)
862 #define touchwin(win) wtouchln((win), 0, getmaxy(win), 1)
863 #define touchline(win, s, c) wtouchln((win), s, c, 1)
864 #define untouchwin(win) wtouchln((win), 0, getmaxy(win), 0)
866 #define box(win, v, h) wborder(win, v, v, h, h, 0, 0, 0, 0)
867 #define border(ls, rs, ts, bs, tl, tr, bl, br) wborder(stdscr, ls, rs, ts, bs, tl, tr, bl, br)
868 #define hline(ch, n) whline(stdscr, ch, n)
869 #define vline(ch, n) wvline(stdscr, ch, n)
871 #define winstr(w, s) winnstr(w, s, -1)
872 #define winchstr(w, s) winchnstr(w, s, -1)
873 #define winsstr(w, s) winsnstr(w, s, -1)
875 #define redrawwin(win) wredrawln(win, 0, (win)->_maxy+1)
876 #define waddstr(win,str) waddnstr(win,str,-1)
877 #define waddchstr(win,str) waddchnstr(win,str,-1)
880 * pseudo functions for standard screen
883 #define addch(ch) waddch(stdscr,ch)
884 #define addchnstr(str,n) waddchnstr(stdscr,str,n)
885 #define addchstr(str) waddchstr(stdscr,str)
886 #define addnstr(str,n) waddnstr(stdscr,str,n)
887 #define addstr(str) waddnstr(stdscr,str,-1)
888 #define attroff(at) wattroff(stdscr,at)
889 #define attron(at) wattron(stdscr,at)
890 #define attrset(at) wattrset(stdscr,at)
891 #define attr_get(ap,cp,o) wattr_get(stdscr,ap,cp,o)
892 #define attr_off(a,o) wattr_off(stdscr,a,o)
893 #define attr_on(a,o) wattr_on(stdscr,a,o)
894 #define attr_set(a,c,o) wattr_set(stdscr,a,c,o)
895 #define bkgd(ch) wbkgd(stdscr,ch)
896 #define bkgdset(ch) wbkgdset(stdscr,ch)
897 #define chgat(n,a,c,o) wchgat(stdscr,n,a,c,o)
898 #define clear() wclear(stdscr)
899 #define clrtobot() wclrtobot(stdscr)
900 #define clrtoeol() wclrtoeol(stdscr)
901 #define color_set(c,o) wcolor_set(stdscr,c,o)
902 #define delch() wdelch(stdscr)
903 #define deleteln() winsdelln(stdscr,-1)
904 #define echochar(c) wechochar(stdscr,c)
905 #define erase() werase(stdscr)
906 #define getch() wgetch(stdscr)
907 #define getstr(str) wgetstr(stdscr,str)
908 #define inch() winch(stdscr)
909 #define inchnstr(s,n) winchnstr(stdscr,s,n)
910 #define inchstr(s) winchstr(stdscr,s)
911 #define innstr(s,n) winnstr(stdscr,s,n)
912 #define insch(c) winsch(stdscr,c)
913 #define insdelln(n) winsdelln(stdscr,n)
914 #define insertln() winsdelln(stdscr,1)
915 #define insnstr(s,n) winsnstr(stdscr,s,n)
916 #define insstr(s) winsstr(stdscr,s)
917 #define instr(s) winstr(stdscr,s)
918 #define move(y,x) wmove(stdscr,y,x)
919 #define refresh() wrefresh(stdscr)
920 #define scrl(n) wscrl(stdscr,n)
921 #define setscrreg(t,b) wsetscrreg(stdscr,t,b)
922 #define standend() wstandend(stdscr)
923 #define standout() wstandout(stdscr)
924 #define timeout(delay) wtimeout(stdscr,delay)
925 #define wdeleteln(win) winsdelln(win,-1)
926 #define winsertln(win) winsdelln(win,1)
929 * mv functions
932 #define mvwaddch(win,y,x,ch) (wmove(win,y,x) == ERR ? ERR : waddch(win,ch))
933 #define mvwaddchnstr(win,y,x,str,n) (wmove(win,y,x) == ERR ? ERR : waddchnstr(win,str,n))
934 #define mvwaddchstr(win,y,x,str) (wmove(win,y,x) == ERR ? ERR : waddchnstr(win,str,-1))
935 #define mvwaddnstr(win,y,x,str,n) (wmove(win,y,x) == ERR ? ERR : waddnstr(win,str,n))
936 #define mvwaddstr(win,y,x,str) (wmove(win,y,x) == ERR ? ERR : waddnstr(win,str,-1))
937 #define mvwdelch(win,y,x) (wmove(win,y,x) == ERR ? ERR : wdelch(win))
938 #define mvwchgat(win,y,x,n,a,c,o) (wmove(win,y,x) == ERR ? ERR : wchgat(win,n,a,c,o))
939 #define mvwgetch(win,y,x) (wmove(win,y,x) == ERR ? ERR : wgetch(win))
940 #define mvwgetnstr(win,y,x,str,n) (wmove(win,y,x) == ERR ? ERR : wgetnstr(win,str,n))
941 #define mvwgetstr(win,y,x,str) (wmove(win,y,x) == ERR ? ERR : wgetstr(win,str))
942 #define mvwhline(win,y,x,c,n) (wmove(win,y,x) == ERR ? ERR : whline(win,c,n))
943 #define mvwinch(win,y,x) (wmove(win,y,x) == ERR ? (chtype)ERR : winch(win))
944 #define mvwinchnstr(win,y,x,s,n) (wmove(win,y,x) == ERR ? ERR : winchnstr(win,s,n))
945 #define mvwinchstr(win,y,x,s) (wmove(win,y,x) == ERR ? ERR : winchstr(win,s))
946 #define mvwinnstr(win,y,x,s,n) (wmove(win,y,x) == ERR ? ERR : winnstr(win,s,n))
947 #define mvwinsch(win,y,x,c) (wmove(win,y,x) == ERR ? ERR : winsch(win,c))
948 #define mvwinsnstr(win,y,x,s,n) (wmove(win,y,x) == ERR ? ERR : winsnstr(win,s,n))
949 #define mvwinsstr(win,y,x,s) (wmove(win,y,x) == ERR ? ERR : winsstr(win,s))
950 #define mvwinstr(win,y,x,s) (wmove(win,y,x) == ERR ? ERR : winstr(win,s))
951 #define mvwvline(win,y,x,c,n) (wmove(win,y,x) == ERR ? ERR : wvline(win,c,n))
953 #define mvaddch(y,x,ch) mvwaddch(stdscr,y,x,ch)
954 #define mvaddchnstr(y,x,str,n) mvwaddchnstr(stdscr,y,x,str,n)
955 #define mvaddchstr(y,x,str) mvwaddchstr(stdscr,y,x,str)
956 #define mvaddnstr(y,x,str,n) mvwaddnstr(stdscr,y,x,str,n)
957 #define mvaddstr(y,x,str) mvwaddstr(stdscr,y,x,str)
958 #define mvchgat(y,x,n,a,c,o) mvwchgat(stdscr,y,x,n,a,c,o)
959 #define mvdelch(y,x) mvwdelch(stdscr,y,x)
960 #define mvgetch(y,x) mvwgetch(stdscr,y,x)
961 #define mvgetnstr(y,x,str,n) mvwgetnstr(stdscr,y,x,str,n)
962 #define mvgetstr(y,x,str) mvwgetstr(stdscr,y,x,str)
963 #define mvhline(y,x,c,n) mvwhline(stdscr,y,x,c,n)
964 #define mvinch(y,x) mvwinch(stdscr,y,x)
965 #define mvinchnstr(y,x,s,n) mvwinchnstr(stdscr,y,x,s,n)
966 #define mvinchstr(y,x,s) mvwinchstr(stdscr,y,x,s)
967 #define mvinnstr(y,x,s,n) mvwinnstr(stdscr,y,x,s,n)
968 #define mvinsch(y,x,c) mvwinsch(stdscr,y,x,c)
969 #define mvinsnstr(y,x,s,n) mvwinsnstr(stdscr,y,x,s,n)
970 #define mvinsstr(y,x,s) mvwinsstr(stdscr,y,x,s)
971 #define mvinstr(y,x,s) mvwinstr(stdscr,y,x,s)
972 #define mvvline(y,x,c,n) mvwvline(stdscr,y,x,c,n)
975 * Some wide-character functions do not depend on the extensions.
977 #define getbkgd(win) ((win)->_bkgd)
979 #define slk_attr_off(a,v) ((v) ? ERR : slk_attroff(a))
980 #define slk_attr_on(a,v) ((v) ? ERR : slk_attron(a))
982 #define wattr_get(win,a,p,opts) ((void)((a) != 0 && (*(a) = (win)->_attrs)), \
983 (void)((p) != 0 && (*(p) = PAIR_NUMBER((win)->_attrs))), \
987 * XSI curses deprecates SVr4 vwprintw/vwscanw, which are supposed to use
988 * varargs.h. It adds new calls vw_printw/vw_scanw, which are supposed to
989 * use POSIX stdarg.h. The ncurses versions of vwprintw/vwscanw already
990 * use stdarg.h, so...
992 #define vw_printw vwprintw
993 #define vw_scanw vwscanw
996 * Export fallback function for use in C++ binding.
998 #if !@HAVE_VSSCANF@
999 #define vsscanf(a,b,c) _nc_vsscanf(a,b,c)
1000 NCURSES_EXPORT(int) vsscanf(const char *, const char *, va_list);
1001 #endif
1004 * Pseudo-character tokens outside ASCII range. The curses wgetch() function
1005 * will return any given one of these only if the corresponding k- capability
1006 * is defined in your terminal's terminfo entry.
1008 * Some keys (KEY_A1, etc) are arranged like this:
1009 * a1 up a3
1010 * left b2 right
1011 * c1 down c3
1013 * A few key codes do not depend upon the terminfo entry.
1015 #define KEY_CODE_YES 0400 /* A wchar_t contains a key code */
1016 #define KEY_MIN 0401 /* Minimum curses key */
1017 #define KEY_BREAK 0401 /* Break key (unreliable) */
1018 #define KEY_SRESET 0530 /* Soft (partial) reset (unreliable) */
1019 #define KEY_RESET 0531 /* Reset or hard reset (unreliable) */