1/****************************************************************************
2 * Copyright 2018-2020,2021 Thomas E. Dickey                                *
3 * Copyright 1998-2016,2017 Free Software Foundation, Inc.                  *
4 *                                                                          *
5 * Permission is hereby granted, free of charge, to any person obtaining a  *
6 * copy of this software and associated documentation files (the            *
7 * "Software"), to deal in the Software without restriction, including      *
8 * without limitation the rights to use, copy, modify, merge, publish,      *
9 * distribute, distribute with modifications, sublicense, and/or sell       *
10 * copies of the Software, and to permit persons to whom the Software is    *
11 * furnished to do so, subject to the following conditions:                 *
12 *                                                                          *
13 * The above copyright notice and this permission notice shall be included  *
14 * in all copies or substantial portions of the Software.                   *
15 *                                                                          *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
19 * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
20 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
21 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
22 * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
23 *                                                                          *
24 * Except as contained in this notice, the name(s) of the above copyright   *
25 * holders shall not be used in advertising or otherwise to promote the     *
26 * sale, use or other dealings in this Software without prior written       *
27 * authorization.                                                           *
28 ****************************************************************************/
29
30/****************************************************************************
31 *  Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995               *
32 *     and: Eric S. Raymond <esr@snark.thyrsus.com>                         *
33 *     and: Thomas E. Dickey                        1996-on                 *
34 ****************************************************************************/
35
36/* $Id: curses.h.in,v 1.277 2021/09/24 16:07:37 tom Exp $ */
37
38#ifndef __NCURSES_H
39#define __NCURSES_H
40
41/*
42 The symbols beginning NCURSES_ or USE_ are configuration choices.
43 A few of the former can be overridden by applications at compile-time.
44 Most of the others correspond to configure-script options (or checks
45 by the configure-script for features of the system on which it is built).
46
47 These symbols can be overridden by applications at compile-time:
48 NCURSES_NOMACROS suppresses macro definitions in favor of functions
49 NCURSES_WATTR_MACROS suppresses wattr_* macro definitions
50 NCURSES_WIDECHAR is an alternative for declaring wide-character functions.
51
52 These symbols are used only when building ncurses:
53 NCURSES_ATTR_T
54 NCURSES_FIELD_INTERNALS
55 NCURSES_INTERNALS
56
57 These symbols are set by the configure script:
58 NCURSES_ENABLE_STDBOOL_H
59 NCURSES_EXPANDED
60 NCURSES_EXT_COLORS
61 NCURSES_EXT_FUNCS
62 NCURSES_EXT_PUTWIN
63 NCURSES_NO_PADDING
64 NCURSES_OSPEED_COMPAT
65 NCURSES_PATHSEP
66 NCURSES_REENTRANT
67 */
68
69#define CURSES 1
70#define CURSES_H 1
71
72/* These are defined only in curses.h, and are used for conditional compiles */
73#define NCURSES_VERSION_MAJOR @NCURSES_MAJOR@
74#define NCURSES_VERSION_MINOR @NCURSES_MINOR@
75#define NCURSES_VERSION_PATCH @NCURSES_PATCH@
76
77/* This is defined in more than one ncurses header, for identification */
78#undef  NCURSES_VERSION
79#define NCURSES_VERSION "@NCURSES_MAJOR@.@NCURSES_MINOR@"
80
81/*
82 * Identify the mouse encoding version.
83 */
84#define NCURSES_MOUSE_VERSION @NCURSES_MOUSE_VERSION@
85
86/*
87 * Definitions to facilitate DLL's.
88 */
89#include <ncurses_dll.h>
90
91/*
92 * Extra headers.
93 */
94#if @HAVE_STDINT_H@
95#include <stdint.h>
96#endif
97
98#ifdef __cplusplus
99#else
100#if @HAVE_STDNORETURN_H@
101#include <stdnoreturn.h>
102#undef GCC_NORETURN
103#define GCC_NORETURN _Noreturn
104#endif
105#endif
106
107/*
108 * User-definable tweak to disable the include of <stdbool.h>.
109 */
110#ifndef NCURSES_ENABLE_STDBOOL_H
111#define NCURSES_ENABLE_STDBOOL_H @cf_cv_header_stdbool_h@
112#endif
113
114/*
115 * NCURSES_ATTR_T is used to quiet compiler warnings when building ncurses
116 * configured using --disable-macros.
117 */
118#ifndef NCURSES_ATTR_T
119#define NCURSES_ATTR_T int
120#endif
121
122/*
123 * Expands to 'const' if ncurses is configured using --enable-const.  Note that
124 * doing so makes it incompatible with other implementations of X/Open Curses.
125 */
126#undef  NCURSES_CONST
127#define NCURSES_CONST @NCURSES_CONST@
128
129#undef NCURSES_INLINE
130#define NCURSES_INLINE @NCURSES_INLINE@
131
132/*
133 * The standard type used for color values, and for color-pairs.  The latter
134 * allows the curses library to enumerate the combinations of foreground and
135 * background colors used by an application, and is normally the product of the
136 * total foreground and background colors.
137 *
138 * X/Open uses "short" for both of these types, ultimately because they are
139 * numbers from the SVr4 terminal database, which uses 16-bit signed values.
140 */
141#undef	NCURSES_COLOR_T
142#define	NCURSES_COLOR_T short
143
144#undef	NCURSES_PAIRS_T
145#define	NCURSES_PAIRS_T short
146
147/*
148 * Definitions used to make WINDOW and similar structs opaque.
149 */
150#ifndef NCURSES_INTERNALS
151#define NCURSES_OPAQUE       @NCURSES_OPAQUE@
152#define NCURSES_OPAQUE_FORM  @NCURSES_OPAQUE_FORM@
153#define NCURSES_OPAQUE_MENU  @NCURSES_OPAQUE_MENU@
154#define NCURSES_OPAQUE_PANEL @NCURSES_OPAQUE_PANEL@
155#endif
156
157/*
158 * Definition used to optionally suppress wattr* macros to help with the
159 * transition from ncurses5 to ncurses6 by allowing the header files to
160 * be shared across development packages for ncursesw in both ABIs.
161 */
162#ifndef NCURSES_WATTR_MACROS
163#define NCURSES_WATTR_MACROS @NCURSES_WATTR_MACROS@
164#endif
165
166/*
167 * The reentrant code relies on the opaque setting, but adds features.
168 */
169#ifndef NCURSES_REENTRANT
170#define NCURSES_REENTRANT @cf_cv_enable_reentrant@
171#endif
172
173/*
174 * In certain environments, we must work around linker problems for data
175 */
176#undef NCURSES_BROKEN_LINKER
177#if @BROKEN_LINKER@
178#define NCURSES_BROKEN_LINKER 1
179#endif
180
181/*
182 * Control whether bindings for interop support are added.
183 */
184#undef	NCURSES_INTEROP_FUNCS
185#define	NCURSES_INTEROP_FUNCS @NCURSES_INTEROP_FUNCS@
186
187/*
188 * The internal type used for window dimensions.
189 */
190#undef	NCURSES_SIZE_T
191#define	NCURSES_SIZE_T @NCURSES_SIZE_T@
192
193/*
194 * Control whether tparm() supports varargs or fixed-parameter list.
195 */
196#undef NCURSES_TPARM_VARARGS
197#define NCURSES_TPARM_VARARGS @NCURSES_TPARM_VARARGS@
198
199/*
200 * Control type used for tparm's arguments.  While X/Open equates long and
201 * char* values, this is not always workable for 64-bit platforms.
202 */
203#undef NCURSES_TPARM_ARG
204#define NCURSES_TPARM_ARG @NCURSES_TPARM_ARG@
205
206/*
207 * Control whether ncurses uses wcwidth() for checking width of line-drawing
208 * characters.
209 */
210#undef NCURSES_WCWIDTH_GRAPHICS
211#define NCURSES_WCWIDTH_GRAPHICS @NCURSES_WCWIDTH_GRAPHICS@
212
213/*
214 * NCURSES_CH_T is used in building the library, but not used otherwise in
215 * this header file, since that would make the normal/wide-character versions
216 * of the header incompatible.
217 */
218#undef	NCURSES_CH_T
219#define NCURSES_CH_T @NCURSES_CH_T@
220
221#if @cf_cv_enable_lp64@ && defined(_LP64)
222typedef unsigned chtype;
223typedef unsigned mmask_t;
224#else
225typedef @cf_cv_typeof_chtype@ chtype;
226typedef @cf_cv_typeof_mmask_t@ mmask_t;
227#endif
228
229/*
230 * We need FILE, etc.  Include this before checking any feature symbols.
231 */
232#include <stdio.h>
233
234/*
235 * With XPG4, you must define _XOPEN_SOURCE_EXTENDED, it is redundant (or
236 * conflicting) when _XOPEN_SOURCE is 500 or greater.  If NCURSES_WIDECHAR is
237 * not already defined, e.g., if the platform relies upon nonstandard feature
238 * test macros, define it at this point if the standard feature test macros
239 * indicate that it should be defined.
240 */
241#ifndef NCURSES_WIDECHAR
242#if defined(_XOPEN_SOURCE_EXTENDED) || (defined(_XOPEN_SOURCE) && (_XOPEN_SOURCE - 0 >= 500))
243#define NCURSES_WIDECHAR 1
244#else
245#define NCURSES_WIDECHAR 0
246#endif
247#endif /* NCURSES_WIDECHAR */
248
249#include <stdarg.h>	/* we need va_list */
250#if NCURSES_WIDECHAR
251#include <stddef.h>	/* we want wchar_t */
252#endif
253
254/* X/Open and SVr4 specify that curses implements 'bool'.  However, C++ may also
255 * implement it.  If so, we must use the C++ compiler's type to avoid conflict
256 * with other interfaces.
257 *
258 * A further complication is that <stdbool.h> may declare 'bool' to be a
259 * different type, such as an enum which is not necessarily compatible with
260 * C++.  If we have <stdbool.h>, make 'bool' a macro, so users may #undef it.
261 * Otherwise, let it remain a typedef to avoid conflicts with other #define's.
262 * In either case, make a typedef for NCURSES_BOOL which can be used if needed
263 * from either C or C++.
264 */
265
266#undef TRUE
267#define TRUE    1
268
269#undef FALSE
270#define FALSE   0
271
272typedef @cf_cv_type_of_bool@ NCURSES_BOOL;
273
274#if @USE_CXX_BOOL@	/* __cplusplus, etc. */
275
276/* use the C++ compiler's bool type */
277#define NCURSES_BOOL bool
278
279#else			/* c89, c99, etc. */
280
281#if NCURSES_ENABLE_STDBOOL_H
282#include <stdbool.h>
283/* use whatever the C compiler decides bool really is */
284#define NCURSES_BOOL bool
285#else
286/* there is no predefined bool - use our own */
287#undef bool
288#define bool NCURSES_BOOL
289#endif
290
291#endif /* !__cplusplus, etc. */
292
293#ifdef __cplusplus
294extern "C" {
295#define NCURSES_CAST(type,value) static_cast<type>(value)
296#else
297#define NCURSES_CAST(type,value) (type)(value)
298#endif
299
300#define NCURSES_OK_ADDR(p) (0 != NCURSES_CAST(const void *, (p)))
301
302/*
303 * X/Open attributes.  In the ncurses implementation, they are identical to the
304 * A_ attributes.
305 */
306#define WA_ATTRIBUTES	A_ATTRIBUTES
307#define WA_NORMAL	A_NORMAL
308#define WA_STANDOUT	A_STANDOUT
309#define WA_UNDERLINE	A_UNDERLINE
310#define WA_REVERSE	A_REVERSE
311#define WA_BLINK	A_BLINK
312#define WA_DIM		A_DIM
313#define WA_BOLD		A_BOLD
314#define WA_ALTCHARSET	A_ALTCHARSET
315#define WA_INVIS	A_INVIS
316#define WA_PROTECT	A_PROTECT
317#define WA_HORIZONTAL	A_HORIZONTAL
318#define WA_LEFT		A_LEFT
319#define WA_LOW		A_LOW
320#define WA_RIGHT	A_RIGHT
321#define WA_TOP		A_TOP
322#define WA_VERTICAL	A_VERTICAL
323
324#if @NCURSES_EXT_FUNCS@
325#define WA_ITALIC	A_ITALIC	/* ncurses extension */
326#endif
327
328/* colors */
329#define COLOR_BLACK	0
330#define COLOR_RED	1
331#define COLOR_GREEN	2
332#define COLOR_YELLOW	3
333#define COLOR_BLUE	4
334#define COLOR_MAGENTA	5
335#define COLOR_CYAN	6
336#define COLOR_WHITE	7
337
338/* line graphics */
339
340#if @BROKEN_LINKER@ || NCURSES_REENTRANT
341NCURSES_WRAPPED_VAR(chtype*, acs_map);
342#define acs_map NCURSES_PUBLIC_VAR(acs_map())
343#else
344extern NCURSES_EXPORT_VAR(chtype) acs_map[];
345#endif
346
347#define NCURSES_ACS(c)	(acs_map[NCURSES_CAST(unsigned char,(c))])
348
349/* VT100 symbols begin here */
350#define ACS_ULCORNER	NCURSES_ACS('l') /* upper left corner */
351#define ACS_LLCORNER	NCURSES_ACS('m') /* lower left corner */
352#define ACS_URCORNER	NCURSES_ACS('k') /* upper right corner */
353#define ACS_LRCORNER	NCURSES_ACS('j') /* lower right corner */
354#define ACS_LTEE	NCURSES_ACS('t') /* tee pointing right */
355#define ACS_RTEE	NCURSES_ACS('u') /* tee pointing left */
356#define ACS_BTEE	NCURSES_ACS('v') /* tee pointing up */
357#define ACS_TTEE	NCURSES_ACS('w') /* tee pointing down */
358#define ACS_HLINE	NCURSES_ACS('q') /* horizontal line */
359#define ACS_VLINE	NCURSES_ACS('x') /* vertical line */
360#define ACS_PLUS	NCURSES_ACS('n') /* large plus or crossover */
361#define ACS_S1		NCURSES_ACS('o') /* scan line 1 */
362#define ACS_S9		NCURSES_ACS('s') /* scan line 9 */
363#define ACS_DIAMOND	NCURSES_ACS('`') /* diamond */
364#define ACS_CKBOARD	NCURSES_ACS('a') /* checker board (stipple) */
365#define ACS_DEGREE	NCURSES_ACS('f') /* degree symbol */
366#define ACS_PLMINUS	NCURSES_ACS('g') /* plus/minus */
367#define ACS_BULLET	NCURSES_ACS('~') /* bullet */
368/* Teletype 5410v1 symbols begin here */
369#define ACS_LARROW	NCURSES_ACS(',') /* arrow pointing left */
370#define ACS_RARROW	NCURSES_ACS('+') /* arrow pointing right */
371#define ACS_DARROW	NCURSES_ACS('.') /* arrow pointing down */
372#define ACS_UARROW	NCURSES_ACS('-') /* arrow pointing up */
373#define ACS_BOARD	NCURSES_ACS('h') /* board of squares */
374#define ACS_LANTERN	NCURSES_ACS('i') /* lantern symbol */
375#define ACS_BLOCK	NCURSES_ACS('0') /* solid square block */
376/*
377 * These aren't documented, but a lot of System Vs have them anyway
378 * (you can spot pprryyzz{{||}} in a lot of AT&T terminfo strings).
379 * The ACS_names may not match AT&T's, our source didn't know them.
380 */
381#define ACS_S3		NCURSES_ACS('p') /* scan line 3 */
382#define ACS_S7		NCURSES_ACS('r') /* scan line 7 */
383#define ACS_LEQUAL	NCURSES_ACS('y') /* less/equal */
384#define ACS_GEQUAL	NCURSES_ACS('z') /* greater/equal */
385#define ACS_PI		NCURSES_ACS('{') /* Pi */
386#define ACS_NEQUAL	NCURSES_ACS('|') /* not equal */
387#define ACS_STERLING	NCURSES_ACS('}') /* UK pound sign */
388
389/*
390 * Line drawing ACS names are of the form ACS_trbl, where t is the top, r
391 * is the right, b is the bottom, and l is the left.  t, r, b, and l might
392 * be B (blank), S (single), D (double), or T (thick).  The subset defined
393 * here only uses B and S.
394 */
395#define ACS_BSSB	ACS_ULCORNER
396#define ACS_SSBB	ACS_LLCORNER
397#define ACS_BBSS	ACS_URCORNER
398#define ACS_SBBS	ACS_LRCORNER
399#define ACS_SBSS	ACS_RTEE
400#define ACS_SSSB	ACS_LTEE
401#define ACS_SSBS	ACS_BTEE
402#define ACS_BSSS	ACS_TTEE
403#define ACS_BSBS	ACS_HLINE
404#define ACS_SBSB	ACS_VLINE
405#define ACS_SSSS	ACS_PLUS
406
407#undef	ERR
408#define ERR     (-1)
409
410#undef	OK
411#define OK      (0)
412
413/* values for the _flags member */
414#define _SUBWIN         0x01	/* is this a sub-window? */
415#define _ENDLINE        0x02	/* is the window flush right? */
416#define _FULLWIN        0x04	/* is the window full-screen? */
417#define _SCROLLWIN      0x08	/* bottom edge is at screen bottom? */
418#define _ISPAD	        0x10	/* is this window a pad? */
419#define _HASMOVED       0x20	/* has cursor moved since last refresh? */
420#define _WRAPPED        0x40	/* cursor was just wrappped */
421
422/*
423 * this value is used in the firstchar and lastchar fields to mark
424 * unchanged lines
425 */
426#define _NOCHANGE       -1
427
428/*
429 * this value is used in the oldindex field to mark lines created by insertions
430 * and scrolls.
431 */
432#define _NEWINDEX	-1
433
434#ifdef NCURSES_INTERNALS
435#undef SCREEN
436#define SCREEN struct screen
437SCREEN;
438#else
439typedef struct screen  SCREEN;
440#endif
441
442typedef struct _win_st WINDOW;
443
444typedef	chtype	attr_t;		/* ...must be at least as wide as chtype */
445
446#if NCURSES_WIDECHAR
447
448#if @NCURSES_LIBUTF8@
449#ifdef mblen			/* libutf8.h defines it w/o undefining first */
450#undef mblen
451#endif
452#include <libutf8.h>
453#endif
454
455#if @NEED_WCHAR_H@
456#include <wchar.h>		/* ...to get mbstate_t, etc. */
457#endif
458
459#if @NCURSES_WCHAR_T@
460typedef unsigned short wchar_t@NCURSES_OK_WCHAR_T@;
461#endif
462
463#if @NCURSES_WINT_T@
464typedef unsigned int wint_t@NCURSES_OK_WCHAR_T@;
465#endif
466
467/*
468 * cchar_t stores an array of CCHARW_MAX wide characters.  The first is
469 * normally a spacing character.  The others are non-spacing.  If those
470 * (spacing and nonspacing) do not fill the array, a null L'\0' follows.
471 * Otherwise, a null is assumed to follow when extracting via getcchar().
472 */
473#define CCHARW_MAX	@NCURSES_CCHARW_MAX@
474typedef struct
475{
476    attr_t	attr;
477    wchar_t	chars[CCHARW_MAX];
478#if @NCURSES_EXT_COLORS@
479#undef NCURSES_EXT_COLORS
480#define NCURSES_EXT_COLORS @NCURSES_PATCH@
481    int		ext_color;	/* color pair, must be more than 16-bits */
482#endif
483}
484cchar_t;
485
486#endif /* NCURSES_WIDECHAR */
487
488#if !NCURSES_OPAQUE
489struct ldat;
490
491struct _win_st
492{
493	NCURSES_SIZE_T _cury, _curx; /* current cursor position */
494
495	/* window location and size */
496	NCURSES_SIZE_T _maxy, _maxx; /* maximums of x and y, NOT window size */
497	NCURSES_SIZE_T _begy, _begx; /* screen coords of upper-left-hand corner */
498
499	short   _flags;		/* window state flags */
500
501	/* attribute tracking */
502	attr_t  _attrs;		/* current attribute for non-space character */
503	chtype  _bkgd;		/* current background char/attribute pair */
504
505	/* option values set by user */
506	bool	_notimeout;	/* no time out on function-key entry? */
507	bool	_clear;		/* consider all data in the window invalid? */
508	bool	_leaveok;	/* OK to not reset cursor on exit? */
509	bool	_scroll;	/* OK to scroll this window? */
510	bool	_idlok;		/* OK to use insert/delete line? */
511	bool	_idcok;		/* OK to use insert/delete char? */
512	bool	_immed;		/* window in immed mode? (not yet used) */
513	bool	_sync;		/* window in sync mode? */
514	bool	_use_keypad;	/* process function keys into KEY_ symbols? */
515	int	_delay;		/* 0 = nodelay, <0 = blocking, >0 = delay */
516
517	struct ldat *_line;	/* the actual line data */
518
519	/* global screen state */
520	NCURSES_SIZE_T _regtop;	/* top line of scrolling region */
521	NCURSES_SIZE_T _regbottom; /* bottom line of scrolling region */
522
523	/* these are used only if this is a sub-window */
524	int	_parx;		/* x coordinate of this window in parent */
525	int	_pary;		/* y coordinate of this window in parent */
526	WINDOW	*_parent;	/* pointer to parent if a sub-window */
527
528	/* these are used only if this is a pad */
529	struct pdat
530	{
531	    NCURSES_SIZE_T _pad_y,      _pad_x;
532	    NCURSES_SIZE_T _pad_top,    _pad_left;
533	    NCURSES_SIZE_T _pad_bottom, _pad_right;
534	} _pad;
535
536	NCURSES_SIZE_T _yoffset; /* real begy is _begy + _yoffset */
537
538#if NCURSES_WIDECHAR
539	cchar_t  _bkgrnd;	/* current background char/attribute pair */
540#if @NCURSES_EXT_COLORS@
541	int	_color;		/* current color-pair for non-space character */
542#endif
543#endif
544};
545#endif /* NCURSES_OPAQUE */
546
547/*
548 * GCC (and some other compilers) define '__attribute__'; we're using this
549 * macro to alert the compiler to flag inconsistencies in printf/scanf-like
550 * function calls.  Just in case '__attribute__' isn't defined, make a dummy.
551 * Old versions of G++ do not accept it anyway, at least not consistently with
552 * GCC.
553 */
554#if !(defined(__GNUC__) || defined(__GNUG__) || defined(__attribute__))
555#define __attribute__(p) /* nothing */
556#endif
557
558/*
559 * We cannot define these in ncurses_cfg.h, since they require parameters to be
560 * passed (that is non-portable).
561 */
562#ifndef GCC_PRINTFLIKE
563#ifndef printf
564#define GCC_PRINTFLIKE(fmt,var) __attribute__((format(printf,fmt,var)))
565#else
566#define GCC_PRINTFLIKE(fmt,var) /*nothing*/
567#endif
568#endif
569
570#ifndef GCC_SCANFLIKE
571#ifndef scanf
572#define GCC_SCANFLIKE(fmt,var)  __attribute__((format(scanf,fmt,var)))
573#else
574#define GCC_SCANFLIKE(fmt,var)  /*nothing*/
575#endif
576#endif
577
578#ifndef	GCC_NORETURN
579#define	GCC_NORETURN /* nothing */
580#endif
581
582#ifndef	GCC_UNUSED
583#define	GCC_UNUSED /* nothing */
584#endif
585
586#undef  GCC_DEPRECATED
587#if (__GNUC__ - 0 > 3 || (__GNUC__ - 0 == 3 && __GNUC_MINOR__ - 0 >= 2)) && !defined(NCURSES_INTERNALS)
588#define GCC_DEPRECATED(msg) __attribute__((deprecated))
589#else
590#define GCC_DEPRECATED(msg) /* nothing */
591#endif
592
593/*
594 * Curses uses a helper function.  Define our type for this to simplify
595 * extending it for the sp-funcs feature.
596 */
597typedef int (*NCURSES_OUTC)(int);
598
599/*
600 * Function prototypes.  This is the complete X/Open Curses list of required
601 * functions.  Those marked `generated' will have sources generated from the
602 * macro definitions later in this file, in order to satisfy XPG4.2
603 * requirements.
604 */
605
606extern NCURSES_EXPORT(int) addch (const chtype);			/* generated */
607extern NCURSES_EXPORT(int) addchnstr (const chtype *, int);		/* generated */
608extern NCURSES_EXPORT(int) addchstr (const chtype *);			/* generated */
609extern NCURSES_EXPORT(int) addnstr (const char *, int);			/* generated */
610extern NCURSES_EXPORT(int) addstr (const char *);			/* generated */
611extern NCURSES_EXPORT(int) attroff (NCURSES_ATTR_T);			/* generated */
612extern NCURSES_EXPORT(int) attron (NCURSES_ATTR_T);			/* generated */
613extern NCURSES_EXPORT(int) attrset (NCURSES_ATTR_T);			/* generated */
614extern NCURSES_EXPORT(int) attr_get (attr_t *, NCURSES_PAIRS_T *, void *);	/* generated */
615extern NCURSES_EXPORT(int) attr_off (attr_t, void *);			/* generated */
616extern NCURSES_EXPORT(int) attr_on (attr_t, void *);			/* generated */
617extern NCURSES_EXPORT(int) attr_set (attr_t, NCURSES_PAIRS_T, void *);		/* generated */
618extern NCURSES_EXPORT(int) baudrate (void);				/* implemented */
619extern NCURSES_EXPORT(int) beep  (void);				/* implemented */
620extern NCURSES_EXPORT(int) bkgd (chtype);				/* generated */
621extern NCURSES_EXPORT(void) bkgdset (chtype);				/* generated */
622extern NCURSES_EXPORT(int) border (chtype,chtype,chtype,chtype,chtype,chtype,chtype,chtype);	/* generated */
623extern NCURSES_EXPORT(int) box (WINDOW *, chtype, chtype);		/* generated */
624extern NCURSES_EXPORT(bool) can_change_color (void);			/* implemented */
625extern NCURSES_EXPORT(int) cbreak (void);				/* implemented */
626extern NCURSES_EXPORT(int) chgat (int, attr_t, NCURSES_PAIRS_T, const void *);	/* generated */
627extern NCURSES_EXPORT(int) clear (void);				/* generated */
628extern NCURSES_EXPORT(int) clearok (WINDOW *,bool);			/* implemented */
629extern NCURSES_EXPORT(int) clrtobot (void);				/* generated */
630extern NCURSES_EXPORT(int) clrtoeol (void);				/* generated */
631extern NCURSES_EXPORT(int) color_content (NCURSES_COLOR_T,NCURSES_COLOR_T*,NCURSES_COLOR_T*,NCURSES_COLOR_T*);	/* implemented */
632extern NCURSES_EXPORT(int) color_set (NCURSES_PAIRS_T,void*);			/* generated */
633extern NCURSES_EXPORT(int) COLOR_PAIR (int);				/* generated */
634extern NCURSES_EXPORT(int) copywin (const WINDOW*,WINDOW*,int,int,int,int,int,int,int);	/* implemented */
635extern NCURSES_EXPORT(int) curs_set (int);				/* implemented */
636extern NCURSES_EXPORT(int) def_prog_mode (void);			/* implemented */
637extern NCURSES_EXPORT(int) def_shell_mode (void);			/* implemented */
638extern NCURSES_EXPORT(int) delay_output (int);				/* implemented */
639extern NCURSES_EXPORT(int) delch (void);				/* generated */
640extern NCURSES_EXPORT(void) delscreen (SCREEN *);			/* implemented */
641extern NCURSES_EXPORT(int) delwin (WINDOW *);				/* implemented */
642extern NCURSES_EXPORT(int) deleteln (void);				/* generated */
643extern NCURSES_EXPORT(WINDOW *) derwin (WINDOW *,int,int,int,int);	/* implemented */
644extern NCURSES_EXPORT(int) doupdate (void);				/* implemented */
645extern NCURSES_EXPORT(WINDOW *) dupwin (WINDOW *);			/* implemented */
646extern NCURSES_EXPORT(int) echo (void);					/* implemented */
647extern NCURSES_EXPORT(int) echochar (const chtype);			/* generated */
648extern NCURSES_EXPORT(int) erase (void);				/* generated */
649extern NCURSES_EXPORT(int) endwin (void);				/* implemented */
650extern NCURSES_EXPORT(char) erasechar (void);				/* implemented */
651extern NCURSES_EXPORT(void) filter (void);				/* implemented */
652extern NCURSES_EXPORT(int) flash (void);				/* implemented */
653extern NCURSES_EXPORT(int) flushinp (void);				/* implemented */
654extern NCURSES_EXPORT(chtype) getbkgd (WINDOW *);			/* generated */
655extern NCURSES_EXPORT(int) getch (void);				/* generated */
656extern NCURSES_EXPORT(int) getnstr (char *, int);			/* generated */
657extern NCURSES_EXPORT(int) getstr (char *);				/* generated */
658extern NCURSES_EXPORT(WINDOW *) getwin (FILE *);			/* implemented */
659extern NCURSES_EXPORT(int) halfdelay (int);				/* implemented */
660extern NCURSES_EXPORT(bool) has_colors (void);				/* implemented */
661extern NCURSES_EXPORT(bool) has_ic (void);				/* implemented */
662extern NCURSES_EXPORT(bool) has_il (void);				/* implemented */
663extern NCURSES_EXPORT(int) hline (chtype, int);				/* generated */
664extern NCURSES_EXPORT(void) idcok (WINDOW *, bool);			/* implemented */
665extern NCURSES_EXPORT(int) idlok (WINDOW *, bool);			/* implemented */
666extern NCURSES_EXPORT(void) immedok (WINDOW *, bool);			/* implemented */
667extern NCURSES_EXPORT(chtype) inch (void);				/* generated */
668extern NCURSES_EXPORT(int) inchnstr (chtype *, int);			/* generated */
669extern NCURSES_EXPORT(int) inchstr (chtype *);				/* generated */
670extern NCURSES_EXPORT(WINDOW *) initscr (void);				/* implemented */
671extern NCURSES_EXPORT(int) init_color (NCURSES_COLOR_T,NCURSES_COLOR_T,NCURSES_COLOR_T,NCURSES_COLOR_T);	/* implemented */
672extern NCURSES_EXPORT(int) init_pair (NCURSES_PAIRS_T,NCURSES_COLOR_T,NCURSES_COLOR_T);		/* implemented */
673extern NCURSES_EXPORT(int) innstr (char *, int);			/* generated */
674extern NCURSES_EXPORT(int) insch (chtype);				/* generated */
675extern NCURSES_EXPORT(int) insdelln (int);				/* generated */
676extern NCURSES_EXPORT(int) insertln (void);				/* generated */
677extern NCURSES_EXPORT(int) insnstr (const char *, int);			/* generated */
678extern NCURSES_EXPORT(int) insstr (const char *);			/* generated */
679extern NCURSES_EXPORT(int) instr (char *);				/* generated */
680extern NCURSES_EXPORT(int) intrflush (WINDOW *,bool);			/* implemented */
681extern NCURSES_EXPORT(bool) isendwin (void);				/* implemented */
682extern NCURSES_EXPORT(bool) is_linetouched (WINDOW *,int);		/* implemented */
683extern NCURSES_EXPORT(bool) is_wintouched (WINDOW *);			/* implemented */
684extern NCURSES_EXPORT(NCURSES_CONST char *) keyname (int);		/* implemented */
685extern NCURSES_EXPORT(int) keypad (WINDOW *,bool);			/* implemented */
686extern NCURSES_EXPORT(char) killchar (void);				/* implemented */
687extern NCURSES_EXPORT(int) leaveok (WINDOW *,bool);			/* implemented */
688extern NCURSES_EXPORT(char *) longname (void);				/* implemented */
689extern NCURSES_EXPORT(int) meta (WINDOW *,bool);			/* implemented */
690extern NCURSES_EXPORT(int) move (int, int);				/* generated */
691extern NCURSES_EXPORT(int) mvaddch (int, int, const chtype);		/* generated */
692extern NCURSES_EXPORT(int) mvaddchnstr (int, int, const chtype *, int);	/* generated */
693extern NCURSES_EXPORT(int) mvaddchstr (int, int, const chtype *);	/* generated */
694extern NCURSES_EXPORT(int) mvaddnstr (int, int, const char *, int);	/* generated */
695extern NCURSES_EXPORT(int) mvaddstr (int, int, const char *);		/* generated */
696extern NCURSES_EXPORT(int) mvchgat (int, int, int, attr_t, NCURSES_PAIRS_T, const void *);	/* generated */
697extern NCURSES_EXPORT(int) mvcur (int,int,int,int);			/* implemented */
698extern NCURSES_EXPORT(int) mvdelch (int, int);				/* generated */
699extern NCURSES_EXPORT(int) mvderwin (WINDOW *, int, int);		/* implemented */
700extern NCURSES_EXPORT(int) mvgetch (int, int);				/* generated */
701extern NCURSES_EXPORT(int) mvgetnstr (int, int, char *, int);		/* generated */
702extern NCURSES_EXPORT(int) mvgetstr (int, int, char *);			/* generated */
703extern NCURSES_EXPORT(int) mvhline (int, int, chtype, int);		/* generated */
704extern NCURSES_EXPORT(chtype) mvinch (int, int);			/* generated */
705extern NCURSES_EXPORT(int) mvinchnstr (int, int, chtype *, int);	/* generated */
706extern NCURSES_EXPORT(int) mvinchstr (int, int, chtype *);		/* generated */
707extern NCURSES_EXPORT(int) mvinnstr (int, int, char *, int);		/* generated */
708extern NCURSES_EXPORT(int) mvinsch (int, int, chtype);			/* generated */
709extern NCURSES_EXPORT(int) mvinsnstr (int, int, const char *, int);	/* generated */
710extern NCURSES_EXPORT(int) mvinsstr (int, int, const char *);		/* generated */
711extern NCURSES_EXPORT(int) mvinstr (int, int, char *);			/* generated */
712extern NCURSES_EXPORT(int) mvprintw (int,int, const char *,...)		/* implemented */
713		GCC_PRINTFLIKE(3,4);
714extern NCURSES_EXPORT(int) mvscanw (int,int, const char *,...)		/* implemented */
715		GCC_SCANFLIKE(3,4);
716extern NCURSES_EXPORT(int) mvvline (int, int, chtype, int);		/* generated */
717extern NCURSES_EXPORT(int) mvwaddch (WINDOW *, int, int, const chtype);	/* generated */
718extern NCURSES_EXPORT(int) mvwaddchnstr (WINDOW *, int, int, const chtype *, int);/* generated */
719extern NCURSES_EXPORT(int) mvwaddchstr (WINDOW *, int, int, const chtype *);	/* generated */
720extern NCURSES_EXPORT(int) mvwaddnstr (WINDOW *, int, int, const char *, int);	/* generated */
721extern NCURSES_EXPORT(int) mvwaddstr (WINDOW *, int, int, const char *);	/* generated */
722extern NCURSES_EXPORT(int) mvwchgat (WINDOW *, int, int, int, attr_t, NCURSES_PAIRS_T, const void *);/* generated */
723extern NCURSES_EXPORT(int) mvwdelch (WINDOW *, int, int);		/* generated */
724extern NCURSES_EXPORT(int) mvwgetch (WINDOW *, int, int);		/* generated */
725extern NCURSES_EXPORT(int) mvwgetnstr (WINDOW *, int, int, char *, int);	/* generated */
726extern NCURSES_EXPORT(int) mvwgetstr (WINDOW *, int, int, char *);	/* generated */
727extern NCURSES_EXPORT(int) mvwhline (WINDOW *, int, int, chtype, int);	/* generated */
728extern NCURSES_EXPORT(int) mvwin (WINDOW *,int,int);			/* implemented */
729extern NCURSES_EXPORT(chtype) mvwinch (WINDOW *, int, int);			/* generated */
730extern NCURSES_EXPORT(int) mvwinchnstr (WINDOW *, int, int, chtype *, int);	/* generated */
731extern NCURSES_EXPORT(int) mvwinchstr (WINDOW *, int, int, chtype *);		/* generated */
732extern NCURSES_EXPORT(int) mvwinnstr (WINDOW *, int, int, char *, int);		/* generated */
733extern NCURSES_EXPORT(int) mvwinsch (WINDOW *, int, int, chtype);		/* generated */
734extern NCURSES_EXPORT(int) mvwinsnstr (WINDOW *, int, int, const char *, int);	/* generated */
735extern NCURSES_EXPORT(int) mvwinsstr (WINDOW *, int, int, const char *);	/* generated */
736extern NCURSES_EXPORT(int) mvwinstr (WINDOW *, int, int, char *);		/* generated */
737extern NCURSES_EXPORT(int) mvwprintw (WINDOW*,int,int, const char *,...)	/* implemented */
738		GCC_PRINTFLIKE(4,5);
739extern NCURSES_EXPORT(int) mvwscanw (WINDOW *,int,int, const char *,...)	/* implemented */
740		GCC_SCANFLIKE(4,5);
741extern NCURSES_EXPORT(int) mvwvline (WINDOW *,int, int, chtype, int);	/* generated */
742extern NCURSES_EXPORT(int) napms (int);					/* implemented */
743extern NCURSES_EXPORT(WINDOW *) newpad (int,int);			/* implemented */
744extern NCURSES_EXPORT(SCREEN *) newterm (const char *,FILE *,FILE *);	/* implemented */
745extern NCURSES_EXPORT(WINDOW *) newwin (int,int,int,int);		/* implemented */
746extern NCURSES_EXPORT(int) nl (void);					/* implemented */
747extern NCURSES_EXPORT(int) nocbreak (void);				/* implemented */
748extern NCURSES_EXPORT(int) nodelay (WINDOW *,bool);			/* implemented */
749extern NCURSES_EXPORT(int) noecho (void);				/* implemented */
750extern NCURSES_EXPORT(int) nonl (void);					/* implemented */
751extern NCURSES_EXPORT(void) noqiflush (void);				/* implemented */
752extern NCURSES_EXPORT(int) noraw (void);				/* implemented */
753extern NCURSES_EXPORT(int) notimeout (WINDOW *,bool);			/* implemented */
754extern NCURSES_EXPORT(int) overlay (const WINDOW*,WINDOW *);		/* implemented */
755extern NCURSES_EXPORT(int) overwrite (const WINDOW*,WINDOW *);		/* implemented */
756extern NCURSES_EXPORT(int) pair_content (NCURSES_PAIRS_T,NCURSES_COLOR_T*,NCURSES_COLOR_T*);		/* implemented */
757extern NCURSES_EXPORT(int) PAIR_NUMBER (int);				/* generated */
758extern NCURSES_EXPORT(int) pechochar (WINDOW *, const chtype);		/* implemented */
759extern NCURSES_EXPORT(int) pnoutrefresh (WINDOW*,int,int,int,int,int,int);/* implemented */
760extern NCURSES_EXPORT(int) prefresh (WINDOW *,int,int,int,int,int,int);	/* implemented */
761extern NCURSES_EXPORT(int) printw (const char *,...)			/* implemented */
762		GCC_PRINTFLIKE(1,2);
763extern NCURSES_EXPORT(int) putwin (WINDOW *, FILE *);			/* implemented */
764extern NCURSES_EXPORT(void) qiflush (void);				/* implemented */
765extern NCURSES_EXPORT(int) raw (void);					/* implemented */
766extern NCURSES_EXPORT(int) redrawwin (WINDOW *);			/* generated */
767extern NCURSES_EXPORT(int) refresh (void);				/* generated */
768extern NCURSES_EXPORT(int) resetty (void);				/* implemented */
769extern NCURSES_EXPORT(int) reset_prog_mode (void);			/* implemented */
770extern NCURSES_EXPORT(int) reset_shell_mode (void);			/* implemented */
771extern NCURSES_EXPORT(int) ripoffline (int, int (*)(WINDOW *, int));	/* implemented */
772extern NCURSES_EXPORT(int) savetty (void);				/* implemented */
773extern NCURSES_EXPORT(int) scanw (const char *,...)			/* implemented */
774		GCC_SCANFLIKE(1,2);
775extern NCURSES_EXPORT(int) scr_dump (const char *);			/* implemented */
776extern NCURSES_EXPORT(int) scr_init (const char *);			/* implemented */
777extern NCURSES_EXPORT(int) scrl (int);					/* generated */
778extern NCURSES_EXPORT(int) scroll (WINDOW *);				/* generated */
779extern NCURSES_EXPORT(int) scrollok (WINDOW *,bool);			/* implemented */
780extern NCURSES_EXPORT(int) scr_restore (const char *);			/* implemented */
781extern NCURSES_EXPORT(int) scr_set (const char *);			/* implemented */
782extern NCURSES_EXPORT(int) setscrreg (int,int);				/* generated */
783extern NCURSES_EXPORT(SCREEN *) set_term (SCREEN *);			/* implemented */
784extern NCURSES_EXPORT(int) slk_attroff (const chtype);			/* implemented */
785extern NCURSES_EXPORT(int) slk_attr_off (const attr_t, void *);		/* generated:WIDEC */
786extern NCURSES_EXPORT(int) slk_attron (const chtype);			/* implemented */
787extern NCURSES_EXPORT(int) slk_attr_on (attr_t,void*);			/* generated:WIDEC */
788extern NCURSES_EXPORT(int) slk_attrset (const chtype);			/* implemented */
789extern NCURSES_EXPORT(attr_t) slk_attr (void);				/* implemented */
790extern NCURSES_EXPORT(int) slk_attr_set (const attr_t,NCURSES_PAIRS_T,void*);	/* implemented */
791extern NCURSES_EXPORT(int) slk_clear (void);				/* implemented */
792extern NCURSES_EXPORT(int) slk_color (NCURSES_PAIRS_T);				/* implemented */
793extern NCURSES_EXPORT(int) slk_init (int);				/* implemented */
794extern NCURSES_EXPORT(char *) slk_label (int);				/* implemented */
795extern NCURSES_EXPORT(int) slk_noutrefresh (void);			/* implemented */
796extern NCURSES_EXPORT(int) slk_refresh (void);				/* implemented */
797extern NCURSES_EXPORT(int) slk_restore (void);				/* implemented */
798extern NCURSES_EXPORT(int) slk_set (int,const char *,int);		/* implemented */
799extern NCURSES_EXPORT(int) slk_touch (void);				/* implemented */
800extern NCURSES_EXPORT(int) standout (void);				/* generated */
801extern NCURSES_EXPORT(int) standend (void);				/* generated */
802extern NCURSES_EXPORT(int) start_color (void);				/* implemented */
803extern NCURSES_EXPORT(WINDOW *) subpad (WINDOW *, int, int, int, int);	/* implemented */
804extern NCURSES_EXPORT(WINDOW *) subwin (WINDOW *, int, int, int, int);	/* implemented */
805extern NCURSES_EXPORT(int) syncok (WINDOW *, bool);			/* implemented */
806extern NCURSES_EXPORT(chtype) termattrs (void);				/* implemented */
807extern NCURSES_EXPORT(char *) termname (void);				/* implemented */
808extern NCURSES_EXPORT(void) timeout (int);				/* generated */
809extern NCURSES_EXPORT(int) touchline (WINDOW *, int, int);		/* generated */
810extern NCURSES_EXPORT(int) touchwin (WINDOW *);				/* generated */
811extern NCURSES_EXPORT(int) typeahead (int);				/* implemented */
812extern NCURSES_EXPORT(int) ungetch (int);				/* implemented */
813extern NCURSES_EXPORT(int) untouchwin (WINDOW *);			/* generated */
814extern NCURSES_EXPORT(void) use_env (bool);				/* implemented */
815extern NCURSES_EXPORT(void) use_tioctl (bool);				/* implemented */
816extern NCURSES_EXPORT(int) vidattr (chtype);				/* implemented */
817extern NCURSES_EXPORT(int) vidputs (chtype, NCURSES_OUTC);		/* implemented */
818extern NCURSES_EXPORT(int) vline (chtype, int);				/* generated */
819extern NCURSES_EXPORT(int) vwprintw (WINDOW *, const char *, va_list) GCC_DEPRECATED(use vw_printw)	/* implemented */
820		GCC_PRINTFLIKE(2,0);
821extern NCURSES_EXPORT(int) vw_printw (WINDOW *, const char *, va_list)	/* implemented */
822		GCC_PRINTFLIKE(2,0);
823extern NCURSES_EXPORT(int) vwscanw (WINDOW *, const char *, va_list) GCC_DEPRECATED(use vw_scanw)	/* implemented */
824		GCC_SCANFLIKE(2,0);
825extern NCURSES_EXPORT(int) vw_scanw (WINDOW *, const char *, va_list)	/* implemented */
826		GCC_SCANFLIKE(2,0);
827extern NCURSES_EXPORT(int) waddch (WINDOW *, const chtype);		/* implemented */
828extern NCURSES_EXPORT(int) waddchnstr (WINDOW *,const chtype *,int);	/* implemented */
829extern NCURSES_EXPORT(int) waddchstr (WINDOW *,const chtype *);		/* generated */
830extern NCURSES_EXPORT(int) waddnstr (WINDOW *,const char *,int);	/* implemented */
831extern NCURSES_EXPORT(int) waddstr (WINDOW *,const char *);		/* generated */
832extern NCURSES_EXPORT(int) wattron (WINDOW *, int);			/* generated */
833extern NCURSES_EXPORT(int) wattroff (WINDOW *, int);			/* generated */
834extern NCURSES_EXPORT(int) wattrset (WINDOW *, int);			/* generated */
835extern NCURSES_EXPORT(int) wattr_get (WINDOW *, attr_t *, NCURSES_PAIRS_T *, void *);	/* generated */
836extern NCURSES_EXPORT(int) wattr_on (WINDOW *, attr_t, void *);		/* implemented */
837extern NCURSES_EXPORT(int) wattr_off (WINDOW *, attr_t, void *);	/* implemented */
838extern NCURSES_EXPORT(int) wattr_set (WINDOW *, attr_t, NCURSES_PAIRS_T, void *);	/* generated */
839extern NCURSES_EXPORT(int) wbkgd (WINDOW *, chtype);			/* implemented */
840extern NCURSES_EXPORT(void) wbkgdset (WINDOW *,chtype);			/* implemented */
841extern NCURSES_EXPORT(int) wborder (WINDOW *,chtype,chtype,chtype,chtype,chtype,chtype,chtype,chtype);	/* implemented */
842extern NCURSES_EXPORT(int) wchgat (WINDOW *, int, attr_t, NCURSES_PAIRS_T, const void *);/* implemented */
843extern NCURSES_EXPORT(int) wclear (WINDOW *);				/* implemented */
844extern NCURSES_EXPORT(int) wclrtobot (WINDOW *);			/* implemented */
845extern NCURSES_EXPORT(int) wclrtoeol (WINDOW *);			/* implemented */
846extern NCURSES_EXPORT(int) wcolor_set (WINDOW*,NCURSES_PAIRS_T,void*);		/* implemented */
847extern NCURSES_EXPORT(void) wcursyncup (WINDOW *);			/* implemented */
848extern NCURSES_EXPORT(int) wdelch (WINDOW *);				/* implemented */
849extern NCURSES_EXPORT(int) wdeleteln (WINDOW *);			/* generated */
850extern NCURSES_EXPORT(int) wechochar (WINDOW *, const chtype);		/* implemented */
851extern NCURSES_EXPORT(int) werase (WINDOW *);				/* implemented */
852extern NCURSES_EXPORT(int) wgetch (WINDOW *);				/* implemented */
853extern NCURSES_EXPORT(int) wgetnstr (WINDOW *,char *,int);		/* implemented */
854extern NCURSES_EXPORT(int) wgetstr (WINDOW *, char *);			/* generated */
855extern NCURSES_EXPORT(int) whline (WINDOW *, chtype, int);		/* implemented */
856extern NCURSES_EXPORT(chtype) winch (WINDOW *);				/* implemented */
857extern NCURSES_EXPORT(int) winchnstr (WINDOW *, chtype *, int);		/* implemented */
858extern NCURSES_EXPORT(int) winchstr (WINDOW *, chtype *);		/* generated */
859extern NCURSES_EXPORT(int) winnstr (WINDOW *, char *, int);		/* implemented */
860extern NCURSES_EXPORT(int) winsch (WINDOW *, chtype);			/* implemented */
861extern NCURSES_EXPORT(int) winsdelln (WINDOW *,int);			/* implemented */
862extern NCURSES_EXPORT(int) winsertln (WINDOW *);			/* generated */
863extern NCURSES_EXPORT(int) winsnstr (WINDOW *, const char *,int);	/* implemented */
864extern NCURSES_EXPORT(int) winsstr (WINDOW *, const char *);		/* generated */
865extern NCURSES_EXPORT(int) winstr (WINDOW *, char *);			/* generated */
866extern NCURSES_EXPORT(int) wmove (WINDOW *,int,int);			/* implemented */
867extern NCURSES_EXPORT(int) wnoutrefresh (WINDOW *);			/* implemented */
868extern NCURSES_EXPORT(int) wprintw (WINDOW *, const char *,...)		/* implemented */
869		GCC_PRINTFLIKE(2,3);
870extern NCURSES_EXPORT(int) wredrawln (WINDOW *,int,int);		/* implemented */
871extern NCURSES_EXPORT(int) wrefresh (WINDOW *);				/* implemented */
872extern NCURSES_EXPORT(int) wscanw (WINDOW *, const char *,...)		/* implemented */
873		GCC_SCANFLIKE(2,3);
874extern NCURSES_EXPORT(int) wscrl (WINDOW *,int);			/* implemented */
875extern NCURSES_EXPORT(int) wsetscrreg (WINDOW *,int,int);		/* implemented */
876extern NCURSES_EXPORT(int) wstandout (WINDOW *);			/* generated */
877extern NCURSES_EXPORT(int) wstandend (WINDOW *);			/* generated */
878extern NCURSES_EXPORT(void) wsyncdown (WINDOW *);			/* implemented */
879extern NCURSES_EXPORT(void) wsyncup (WINDOW *);				/* implemented */
880extern NCURSES_EXPORT(void) wtimeout (WINDOW *,int);			/* implemented */
881extern NCURSES_EXPORT(int) wtouchln (WINDOW *,int,int,int);		/* implemented */
882extern NCURSES_EXPORT(int) wvline (WINDOW *,chtype,int);		/* implemented */
883
884/*
885 * These are also declared in <term.h>:
886 */
887extern NCURSES_EXPORT(int) tigetflag (const char *);			/* implemented */
888extern NCURSES_EXPORT(int) tigetnum (const char *);			/* implemented */
889extern NCURSES_EXPORT(char *) tigetstr (const char *);			/* implemented */
890extern NCURSES_EXPORT(int) putp (const char *);				/* implemented */
891
892#if NCURSES_TPARM_VARARGS
893extern NCURSES_EXPORT(char *) tparm (const char *, ...);		/* special */
894#else
895extern NCURSES_EXPORT(char *) tparm (const char *, NCURSES_TPARM_ARG,NCURSES_TPARM_ARG,NCURSES_TPARM_ARG,NCURSES_TPARM_ARG,NCURSES_TPARM_ARG,NCURSES_TPARM_ARG,NCURSES_TPARM_ARG,NCURSES_TPARM_ARG,NCURSES_TPARM_ARG);	/* special */
896#endif
897
898extern NCURSES_EXPORT(char *) tiparm (const char *, ...);		/* special */
899
900/*
901 * These functions are not in X/Open, but we use them in macro definitions:
902 */
903extern NCURSES_EXPORT(int) getattrs (const WINDOW *);			/* generated */
904extern NCURSES_EXPORT(int) getcurx (const WINDOW *);			/* generated */
905extern NCURSES_EXPORT(int) getcury (const WINDOW *);			/* generated */
906extern NCURSES_EXPORT(int) getbegx (const WINDOW *);			/* generated */
907extern NCURSES_EXPORT(int) getbegy (const WINDOW *);			/* generated */
908extern NCURSES_EXPORT(int) getmaxx (const WINDOW *);			/* generated */
909extern NCURSES_EXPORT(int) getmaxy (const WINDOW *);			/* generated */
910extern NCURSES_EXPORT(int) getparx (const WINDOW *);			/* generated */
911extern NCURSES_EXPORT(int) getpary (const WINDOW *);			/* generated */
912
913/*
914 * vid_attr() was implemented originally based on a draft of X/Open curses.
915 */
916#if !NCURSES_WIDECHAR
917#define vid_attr(a,pair,opts) vidattr(a)
918#endif
919
920/*
921 * These functions are extensions - not in X/Open Curses.
922 */
923#if @NCURSES_EXT_FUNCS@
924#undef  NCURSES_EXT_FUNCS
925#define NCURSES_EXT_FUNCS @NCURSES_PATCH@
926typedef int (*NCURSES_WINDOW_CB)(WINDOW *, void *);
927typedef int (*NCURSES_SCREEN_CB)(SCREEN *, void *);
928extern NCURSES_EXPORT(bool) is_term_resized (int, int);
929extern NCURSES_EXPORT(char *) keybound (int, int);
930extern NCURSES_EXPORT(const char *) curses_version (void);
931extern NCURSES_EXPORT(int) alloc_pair (int, int);
932extern NCURSES_EXPORT(int) assume_default_colors (int, int);
933extern NCURSES_EXPORT(int) define_key (const char *, int);
934extern NCURSES_EXPORT(int) extended_color_content(int, int *, int *, int *);
935extern NCURSES_EXPORT(int) extended_pair_content(int, int *, int *);
936extern NCURSES_EXPORT(int) extended_slk_color(int);
937extern NCURSES_EXPORT(int) find_pair (int, int);
938extern NCURSES_EXPORT(int) free_pair (int);
939extern NCURSES_EXPORT(int) get_escdelay (void);
940extern NCURSES_EXPORT(int) init_extended_color(int, int, int, int);
941extern NCURSES_EXPORT(int) init_extended_pair(int, int, int);
942extern NCURSES_EXPORT(int) key_defined (const char *);
943extern NCURSES_EXPORT(int) keyok (int, bool);
944extern NCURSES_EXPORT(void) reset_color_pairs (void);
945extern NCURSES_EXPORT(int) resize_term (int, int);
946extern NCURSES_EXPORT(int) resizeterm (int, int);
947extern NCURSES_EXPORT(int) set_escdelay (int);
948extern NCURSES_EXPORT(int) set_tabsize (int);
949extern NCURSES_EXPORT(int) use_default_colors (void);
950extern NCURSES_EXPORT(int) use_extended_names (bool);
951extern NCURSES_EXPORT(int) use_legacy_coding (int);
952extern NCURSES_EXPORT(int) use_screen (SCREEN *, NCURSES_SCREEN_CB, void *);
953extern NCURSES_EXPORT(int) use_window (WINDOW *, NCURSES_WINDOW_CB, void *);
954extern NCURSES_EXPORT(int) wresize (WINDOW *, int, int);
955extern NCURSES_EXPORT(void) nofilter(void);
956
957/*
958 * These extensions provide access to information stored in the WINDOW even
959 * when NCURSES_OPAQUE is set:
960 */
961extern NCURSES_EXPORT(WINDOW *) wgetparent (const WINDOW *);	/* @GENERATED_EXT_FUNCS@ */
962extern NCURSES_EXPORT(bool) is_cleared (const WINDOW *);	/* @GENERATED_EXT_FUNCS@ */
963extern NCURSES_EXPORT(bool) is_idcok (const WINDOW *);		/* @GENERATED_EXT_FUNCS@ */
964extern NCURSES_EXPORT(bool) is_idlok (const WINDOW *);		/* @GENERATED_EXT_FUNCS@ */
965extern NCURSES_EXPORT(bool) is_immedok (const WINDOW *);	/* @GENERATED_EXT_FUNCS@ */
966extern NCURSES_EXPORT(bool) is_keypad (const WINDOW *);		/* @GENERATED_EXT_FUNCS@ */
967extern NCURSES_EXPORT(bool) is_leaveok (const WINDOW *);	/* @GENERATED_EXT_FUNCS@ */
968extern NCURSES_EXPORT(bool) is_nodelay (const WINDOW *);	/* @GENERATED_EXT_FUNCS@ */
969extern NCURSES_EXPORT(bool) is_notimeout (const WINDOW *);	/* @GENERATED_EXT_FUNCS@ */
970extern NCURSES_EXPORT(bool) is_pad (const WINDOW *);		/* @GENERATED_EXT_FUNCS@ */
971extern NCURSES_EXPORT(bool) is_scrollok (const WINDOW *);	/* @GENERATED_EXT_FUNCS@ */
972extern NCURSES_EXPORT(bool) is_subwin (const WINDOW *);		/* @GENERATED_EXT_FUNCS@ */
973extern NCURSES_EXPORT(bool) is_syncok (const WINDOW *);		/* @GENERATED_EXT_FUNCS@ */
974extern NCURSES_EXPORT(int) wgetdelay (const WINDOW *);		/* @GENERATED_EXT_FUNCS@ */
975extern NCURSES_EXPORT(int) wgetscrreg (const WINDOW *, int *, int *); /* @GENERATED_EXT_FUNCS@ */
976
977#else
978#define curses_version() NCURSES_VERSION
979#endif
980
981/*
982 * Extra extension-functions, which pass a SCREEN pointer rather than using
983 * a global variable SP.
984 */
985#if @NCURSES_SP_FUNCS@
986#undef  NCURSES_SP_FUNCS
987#define NCURSES_SP_FUNCS @NCURSES_PATCH@
988#define NCURSES_SP_NAME(name) name##_sp
989
990/* Define the sp-funcs helper function */
991#define NCURSES_SP_OUTC NCURSES_SP_NAME(NCURSES_OUTC)
992typedef int (*NCURSES_SP_OUTC)(SCREEN*, int);
993
994extern NCURSES_EXPORT(SCREEN *) new_prescr (void); /* implemented:SP_FUNC */
995
996extern NCURSES_EXPORT(int) NCURSES_SP_NAME(baudrate) (SCREEN*); /* implemented:SP_FUNC */
997extern NCURSES_EXPORT(int) NCURSES_SP_NAME(beep) (SCREEN*); /* implemented:SP_FUNC */
998extern NCURSES_EXPORT(bool) NCURSES_SP_NAME(can_change_color) (SCREEN*); /* implemented:SP_FUNC */
999extern NCURSES_EXPORT(int) NCURSES_SP_NAME(cbreak) (SCREEN*); /* implemented:SP_FUNC */
1000extern NCURSES_EXPORT(int) NCURSES_SP_NAME(curs_set) (SCREEN*, int); /* implemented:SP_FUNC */
1001extern NCURSES_EXPORT(int) NCURSES_SP_NAME(color_content) (SCREEN*, NCURSES_PAIRS_T, NCURSES_COLOR_T*, NCURSES_COLOR_T*, NCURSES_COLOR_T*); /* implemented:SP_FUNC */
1002extern NCURSES_EXPORT(int) NCURSES_SP_NAME(def_prog_mode) (SCREEN*); /* implemented:SP_FUNC */
1003extern NCURSES_EXPORT(int) NCURSES_SP_NAME(def_shell_mode) (SCREEN*); /* implemented:SP_FUNC */
1004extern NCURSES_EXPORT(int) NCURSES_SP_NAME(delay_output) (SCREEN*, int); /* implemented:SP_FUNC */
1005extern NCURSES_EXPORT(int) NCURSES_SP_NAME(doupdate) (SCREEN*); /* implemented:SP_FUNC */
1006extern NCURSES_EXPORT(int) NCURSES_SP_NAME(echo) (SCREEN*); /* implemented:SP_FUNC */
1007extern NCURSES_EXPORT(int) NCURSES_SP_NAME(endwin) (SCREEN*); /* implemented:SP_FUNC */
1008extern NCURSES_EXPORT(char) NCURSES_SP_NAME(erasechar) (SCREEN*);/* implemented:SP_FUNC */
1009extern NCURSES_EXPORT(void) NCURSES_SP_NAME(filter) (SCREEN*); /* implemented:SP_FUNC */
1010extern NCURSES_EXPORT(int) NCURSES_SP_NAME(flash) (SCREEN*); /* implemented:SP_FUNC */
1011extern NCURSES_EXPORT(int) NCURSES_SP_NAME(flushinp) (SCREEN*); /* implemented:SP_FUNC */
1012extern NCURSES_EXPORT(WINDOW *) NCURSES_SP_NAME(getwin) (SCREEN*, FILE *);			/* implemented:SP_FUNC */
1013extern NCURSES_EXPORT(int) NCURSES_SP_NAME(halfdelay) (SCREEN*, int); /* implemented:SP_FUNC */
1014extern NCURSES_EXPORT(bool) NCURSES_SP_NAME(has_colors) (SCREEN*); /* implemented:SP_FUNC */
1015extern NCURSES_EXPORT(bool) NCURSES_SP_NAME(has_ic) (SCREEN*); /* implemented:SP_FUNC */
1016extern NCURSES_EXPORT(bool) NCURSES_SP_NAME(has_il) (SCREEN*); /* implemented:SP_FUNC */
1017extern NCURSES_EXPORT(int) NCURSES_SP_NAME(init_color) (SCREEN*, NCURSES_COLOR_T, NCURSES_COLOR_T, NCURSES_COLOR_T, NCURSES_COLOR_T); /* implemented:SP_FUNC */
1018extern NCURSES_EXPORT(int) NCURSES_SP_NAME(init_pair) (SCREEN*, NCURSES_PAIRS_T, NCURSES_COLOR_T, NCURSES_COLOR_T); /* implemented:SP_FUNC */
1019extern NCURSES_EXPORT(int) NCURSES_SP_NAME(intrflush) (SCREEN*, WINDOW*, bool);	/* implemented:SP_FUNC */
1020extern NCURSES_EXPORT(bool) NCURSES_SP_NAME(isendwin) (SCREEN*); /* implemented:SP_FUNC */
1021extern NCURSES_EXPORT(NCURSES_CONST char *) NCURSES_SP_NAME(keyname) (SCREEN*, int); /* implemented:SP_FUNC */
1022extern NCURSES_EXPORT(char) NCURSES_SP_NAME(killchar) (SCREEN*); /* implemented:SP_FUNC */
1023extern NCURSES_EXPORT(char *) NCURSES_SP_NAME(longname) (SCREEN*); /* implemented:SP_FUNC */
1024extern NCURSES_EXPORT(int) NCURSES_SP_NAME(mvcur) (SCREEN*, int, int, int, int); /* implemented:SP_FUNC */
1025extern NCURSES_EXPORT(int) NCURSES_SP_NAME(napms) (SCREEN*, int); /* implemented:SP_FUNC */
1026extern NCURSES_EXPORT(WINDOW *) NCURSES_SP_NAME(newpad) (SCREEN*, int, int); /* implemented:SP_FUNC */
1027extern NCURSES_EXPORT(SCREEN *) NCURSES_SP_NAME(newterm) (SCREEN*, const char *, FILE *, FILE *); /* implemented:SP_FUNC */
1028extern NCURSES_EXPORT(WINDOW *) NCURSES_SP_NAME(newwin) (SCREEN*, int, int, int, int); /* implemented:SP_FUNC */
1029extern NCURSES_EXPORT(int) NCURSES_SP_NAME(nl) (SCREEN*); /* implemented:SP_FUNC */
1030extern NCURSES_EXPORT(int) NCURSES_SP_NAME(nocbreak) (SCREEN*); /* implemented:SP_FUNC */
1031extern NCURSES_EXPORT(int) NCURSES_SP_NAME(noecho) (SCREEN*); /* implemented:SP_FUNC */
1032extern NCURSES_EXPORT(int) NCURSES_SP_NAME(nonl) (SCREEN*); /* implemented:SP_FUNC */
1033extern NCURSES_EXPORT(void) NCURSES_SP_NAME(noqiflush) (SCREEN*); /* implemented:SP_FUNC */
1034extern NCURSES_EXPORT(int) NCURSES_SP_NAME(noraw) (SCREEN*); /* implemented:SP_FUNC */
1035extern NCURSES_EXPORT(int) NCURSES_SP_NAME(pair_content) (SCREEN*, NCURSES_PAIRS_T, NCURSES_COLOR_T*, NCURSES_COLOR_T*); /* implemented:SP_FUNC */
1036extern NCURSES_EXPORT(void) NCURSES_SP_NAME(qiflush) (SCREEN*); /* implemented:SP_FUNC */
1037extern NCURSES_EXPORT(int) NCURSES_SP_NAME(raw) (SCREEN*); /* implemented:SP_FUNC */
1038extern NCURSES_EXPORT(int) NCURSES_SP_NAME(reset_prog_mode) (SCREEN*); /* implemented:SP_FUNC */
1039extern NCURSES_EXPORT(int) NCURSES_SP_NAME(reset_shell_mode) (SCREEN*); /* implemented:SP_FUNC */
1040extern NCURSES_EXPORT(int) NCURSES_SP_NAME(resetty) (SCREEN*); /* implemented:SP_FUNC */
1041extern NCURSES_EXPORT(int) NCURSES_SP_NAME(ripoffline) (SCREEN*, int, int (*)(WINDOW *, int));	/* implemented:SP_FUNC */
1042extern NCURSES_EXPORT(int) NCURSES_SP_NAME(savetty) (SCREEN*); /* implemented:SP_FUNC */
1043extern NCURSES_EXPORT(int) NCURSES_SP_NAME(scr_init) (SCREEN*, const char *); /* implemented:SP_FUNC */
1044extern NCURSES_EXPORT(int) NCURSES_SP_NAME(scr_restore) (SCREEN*, const char *); /* implemented:SP_FUNC */
1045extern NCURSES_EXPORT(int) NCURSES_SP_NAME(scr_set) (SCREEN*, const char *); /* implemented:SP_FUNC */
1046extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_attroff) (SCREEN*, const chtype); /* implemented:SP_FUNC */
1047extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_attron) (SCREEN*, const chtype); /* implemented:SP_FUNC */
1048extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_attrset) (SCREEN*, const chtype); /* implemented:SP_FUNC */
1049extern NCURSES_EXPORT(attr_t) NCURSES_SP_NAME(slk_attr) (SCREEN*); /* implemented:SP_FUNC */
1050extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_attr_set) (SCREEN*, const attr_t, NCURSES_PAIRS_T, void*); /* implemented:SP_FUNC */
1051extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_clear) (SCREEN*); /* implemented:SP_FUNC */
1052extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_color) (SCREEN*, NCURSES_PAIRS_T); /* implemented:SP_FUNC */
1053extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_init) (SCREEN*, int); /* implemented:SP_FUNC */
1054extern NCURSES_EXPORT(char *) NCURSES_SP_NAME(slk_label) (SCREEN*, int); /* implemented:SP_FUNC */
1055extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_noutrefresh) (SCREEN*); /* implemented:SP_FUNC */
1056extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_refresh) (SCREEN*); /* implemented:SP_FUNC */
1057extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_restore) (SCREEN*); /* implemented:SP_FUNC */
1058extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_set) (SCREEN*, int, const char *, int); /* implemented:SP_FUNC */
1059extern NCURSES_EXPORT(int) NCURSES_SP_NAME(slk_touch) (SCREEN*); /* implemented:SP_FUNC */
1060extern NCURSES_EXPORT(int) NCURSES_SP_NAME(start_color) (SCREEN*); /* implemented:SP_FUNC */
1061extern NCURSES_EXPORT(chtype) NCURSES_SP_NAME(termattrs) (SCREEN*); /* implemented:SP_FUNC */
1062extern NCURSES_EXPORT(char *) NCURSES_SP_NAME(termname) (SCREEN*); /* implemented:SP_FUNC */
1063extern NCURSES_EXPORT(int) NCURSES_SP_NAME(typeahead) (SCREEN*, int); /* implemented:SP_FUNC */
1064extern NCURSES_EXPORT(int) NCURSES_SP_NAME(ungetch) (SCREEN*, int); /* implemented:SP_FUNC */
1065extern NCURSES_EXPORT(void) NCURSES_SP_NAME(use_env) (SCREEN*, bool); /* implemented:SP_FUNC */
1066extern NCURSES_EXPORT(void) NCURSES_SP_NAME(use_tioctl) (SCREEN*, bool); /* implemented:SP_FUNC */
1067extern NCURSES_EXPORT(int) NCURSES_SP_NAME(vidattr) (SCREEN*, chtype);	/* implemented:SP_FUNC */
1068extern NCURSES_EXPORT(int) NCURSES_SP_NAME(vidputs) (SCREEN*, chtype, NCURSES_SP_OUTC); /* implemented:SP_FUNC */
1069#if @NCURSES_EXT_FUNCS@
1070extern NCURSES_EXPORT(char *) NCURSES_SP_NAME(keybound) (SCREEN*, int, int);	/* implemented:EXT_SP_FUNC */
1071extern NCURSES_EXPORT(int) NCURSES_SP_NAME(alloc_pair) (SCREEN*, int, int); /* implemented:EXT_SP_FUNC */
1072extern NCURSES_EXPORT(int) NCURSES_SP_NAME(assume_default_colors) (SCREEN*, int, int);	/* implemented:EXT_SP_FUNC */
1073extern NCURSES_EXPORT(int) NCURSES_SP_NAME(define_key) (SCREEN*, const char *, int);	/* implemented:EXT_SP_FUNC */
1074extern NCURSES_EXPORT(int) NCURSES_SP_NAME(extended_color_content) (SCREEN*, int, int *, int *, int *);	/* implemented:EXT_SP_FUNC */
1075extern NCURSES_EXPORT(int) NCURSES_SP_NAME(extended_pair_content) (SCREEN*, int, int *, int *);	/* implemented:EXT_SP_FUNC */
1076extern NCURSES_EXPORT(int) NCURSES_SP_NAME(extended_slk_color) (SCREEN*, int);	/* implemented:EXT_SP_FUNC */
1077extern NCURSES_EXPORT(int) NCURSES_SP_NAME(get_escdelay) (SCREEN*);	/* implemented:EXT_SP_FUNC */
1078extern NCURSES_EXPORT(int) NCURSES_SP_NAME(find_pair) (SCREEN*, int, int); /* implemented:EXT_SP_FUNC */
1079extern NCURSES_EXPORT(int) NCURSES_SP_NAME(free_pair) (SCREEN*, int); /* implemented:EXT_SP_FUNC */
1080extern NCURSES_EXPORT(int) NCURSES_SP_NAME(init_extended_color) (SCREEN*, int, int, int, int);	/* implemented:EXT_SP_FUNC */
1081extern NCURSES_EXPORT(int) NCURSES_SP_NAME(init_extended_pair) (SCREEN*, int, int, int);	/* implemented:EXT_SP_FUNC */
1082extern NCURSES_EXPORT(bool) NCURSES_SP_NAME(is_term_resized) (SCREEN*, int, int);	/* implemented:EXT_SP_FUNC */
1083extern NCURSES_EXPORT(int) NCURSES_SP_NAME(key_defined) (SCREEN*, const char *);	/* implemented:EXT_SP_FUNC */
1084extern NCURSES_EXPORT(int) NCURSES_SP_NAME(keyok) (SCREEN*, int, bool);	/* implemented:EXT_SP_FUNC */
1085extern NCURSES_EXPORT(void) NCURSES_SP_NAME(nofilter) (SCREEN*); /* implemented */	/* implemented:EXT_SP_FUNC */
1086extern NCURSES_EXPORT(void) NCURSES_SP_NAME(reset_color_pairs) (SCREEN*); /* implemented:EXT_SP_FUNC */
1087extern NCURSES_EXPORT(int) NCURSES_SP_NAME(resize_term) (SCREEN*, int, int);	/* implemented:EXT_SP_FUNC */
1088extern NCURSES_EXPORT(int) NCURSES_SP_NAME(resizeterm) (SCREEN*, int, int);	/* implemented:EXT_SP_FUNC */
1089extern NCURSES_EXPORT(int) NCURSES_SP_NAME(set_escdelay) (SCREEN*, int);	/* implemented:EXT_SP_FUNC */
1090extern NCURSES_EXPORT(int) NCURSES_SP_NAME(set_tabsize) (SCREEN*, int);	/* implemented:EXT_SP_FUNC */
1091extern NCURSES_EXPORT(int) NCURSES_SP_NAME(use_default_colors) (SCREEN*);	/* implemented:EXT_SP_FUNC */
1092extern NCURSES_EXPORT(int) NCURSES_SP_NAME(use_legacy_coding) (SCREEN*, int);	/* implemented:EXT_SP_FUNC */
1093#endif
1094#else
1095#undef  NCURSES_SP_FUNCS
1096#define NCURSES_SP_FUNCS 0
1097#define NCURSES_SP_NAME(name) name
1098#define NCURSES_SP_OUTC NCURSES_OUTC
1099#endif
1100
1101/* attributes */
1102
1103#define NCURSES_ATTR_SHIFT       8
1104#define NCURSES_BITS(mask,shift) (NCURSES_CAST(chtype,(mask)) << ((shift) + NCURSES_ATTR_SHIFT))
1105
1106#define A_NORMAL	(@cf_cv_1UL@ - @cf_cv_1UL@)
1107#define A_ATTRIBUTES	NCURSES_BITS(~(@cf_cv_1UL@ - @cf_cv_1UL@),0)
1108#define A_CHARTEXT	(NCURSES_BITS(@cf_cv_1UL@,0) - @cf_cv_1UL@)
1109#define A_COLOR		NCURSES_BITS(((@cf_cv_1UL@) << 8) - @cf_cv_1UL@,0)
1110#define A_STANDOUT	NCURSES_BITS(@cf_cv_1UL@,8)
1111#define A_UNDERLINE	NCURSES_BITS(@cf_cv_1UL@,9)
1112#define A_REVERSE	NCURSES_BITS(@cf_cv_1UL@,10)
1113#define A_BLINK		NCURSES_BITS(@cf_cv_1UL@,11)
1114#define A_DIM		NCURSES_BITS(@cf_cv_1UL@,12)
1115#define A_BOLD		NCURSES_BITS(@cf_cv_1UL@,13)
1116#define A_ALTCHARSET	NCURSES_BITS(@cf_cv_1UL@,14)
1117#define A_INVIS		NCURSES_BITS(@cf_cv_1UL@,15)
1118#define A_PROTECT	NCURSES_BITS(@cf_cv_1UL@,16)
1119#define A_HORIZONTAL	NCURSES_BITS(@cf_cv_1UL@,17)
1120#define A_LEFT		NCURSES_BITS(@cf_cv_1UL@,18)
1121#define A_LOW		NCURSES_BITS(@cf_cv_1UL@,19)
1122#define A_RIGHT		NCURSES_BITS(@cf_cv_1UL@,20)
1123#define A_TOP		NCURSES_BITS(@cf_cv_1UL@,21)
1124#define A_VERTICAL	NCURSES_BITS(@cf_cv_1UL@,22)
1125
1126#if @NCURSES_EXT_FUNCS@
1127#define A_ITALIC	NCURSES_BITS(@cf_cv_1UL@,23)	/* ncurses extension */
1128#endif
1129
1130/*
1131 * Most of the pseudo functions are macros that either provide compatibility
1132 * with older versions of curses, or provide inline functionality to improve
1133 * performance.
1134 */
1135
1136/*
1137 * These pseudo functions are always implemented as macros:
1138 */
1139
1140#define getyx(win,y,x)		(y = getcury(win), x = getcurx(win))
1141#define getbegyx(win,y,x)	(y = getbegy(win), x = getbegx(win))
1142#define getmaxyx(win,y,x)	(y = getmaxy(win), x = getmaxx(win))
1143#define getparyx(win,y,x)	(y = getpary(win), x = getparx(win))
1144
1145#define getsyx(y,x) do { if (newscr) { \
1146			     if (is_leaveok(newscr)) \
1147				(y) = (x) = -1; \
1148			     else \
1149				 getyx(newscr,(y), (x)); \
1150			} \
1151		    } while(0)
1152
1153#define setsyx(y,x) do { if (newscr) { \
1154			    if ((y) == -1 && (x) == -1) \
1155				leaveok(newscr, TRUE); \
1156			    else { \
1157				leaveok(newscr, FALSE); \
1158				wmove(newscr, (y), (x)); \
1159			    } \
1160			} \
1161		    } while(0)
1162
1163#ifndef NCURSES_NOMACROS
1164
1165/*
1166 * These miscellaneous pseudo functions are provided for compatibility:
1167 */
1168
1169#define wgetstr(w, s)		wgetnstr(w, s, -1)
1170#define getnstr(s, n)		wgetnstr(stdscr, s, (n))
1171
1172#define setterm(term)		setupterm(term, 1, (int *)0)
1173
1174#define fixterm()		reset_prog_mode()
1175#define resetterm()		reset_shell_mode()
1176#define saveterm()		def_prog_mode()
1177#define crmode()		cbreak()
1178#define nocrmode()		nocbreak()
1179#define gettmode()
1180
1181/* It seems older SYSV curses versions define these */
1182#if !NCURSES_OPAQUE
1183#define getattrs(win)		NCURSES_CAST(int, NCURSES_OK_ADDR(win) ? (win)->_attrs : A_NORMAL)
1184#define getcurx(win)		(NCURSES_OK_ADDR(win) ? (win)->_curx : ERR)
1185#define getcury(win)		(NCURSES_OK_ADDR(win) ? (win)->_cury : ERR)
1186#define getbegx(win)		(NCURSES_OK_ADDR(win) ? (win)->_begx : ERR)
1187#define getbegy(win)		(NCURSES_OK_ADDR(win) ? (win)->_begy : ERR)
1188#define getmaxx(win)		(NCURSES_OK_ADDR(win) ? ((win)->_maxx + 1) : ERR)
1189#define getmaxy(win)		(NCURSES_OK_ADDR(win) ? ((win)->_maxy + 1) : ERR)
1190#define getparx(win)		(NCURSES_OK_ADDR(win) ? (win)->_parx : ERR)
1191#define getpary(win)		(NCURSES_OK_ADDR(win) ? (win)->_pary : ERR)
1192#endif /* NCURSES_OPAQUE */
1193
1194#define wstandout(win)		(wattrset(win,A_STANDOUT))
1195#define wstandend(win)		(wattrset(win,A_NORMAL))
1196
1197#define wattron(win,at)		wattr_on(win, NCURSES_CAST(attr_t, at), NULL)
1198#define wattroff(win,at)	wattr_off(win, NCURSES_CAST(attr_t, at), NULL)
1199
1200#if !NCURSES_OPAQUE
1201#if NCURSES_WATTR_MACROS
1202#if NCURSES_WIDECHAR && @NCURSES_EXT_COLORS@
1203#define wattrset(win,at) \
1204	(NCURSES_OK_ADDR(win) \
1205	  ? ((win)->_color = NCURSES_CAST(int, PAIR_NUMBER(at)), \
1206	     (win)->_attrs = NCURSES_CAST(attr_t, at), \
1207	     OK) \
1208	  : ERR)
1209#else
1210#define wattrset(win,at) \
1211	(NCURSES_OK_ADDR(win) \
1212	  ? ((win)->_attrs = NCURSES_CAST(attr_t, at), \
1213	     OK) \
1214	  : ERR)
1215#endif
1216#endif /* NCURSES_WATTR_MACROS */
1217#endif /* NCURSES_OPAQUE */
1218
1219#define scroll(win)		wscrl(win,1)
1220
1221#define touchwin(win)		wtouchln((win), 0, getmaxy(win), 1)
1222#define touchline(win, s, c)	wtouchln((win), s, c, 1)
1223#define untouchwin(win)		wtouchln((win), 0, getmaxy(win), 0)
1224
1225#define box(win, v, h)		wborder(win, v, v, h, h, 0, 0, 0, 0)
1226#define border(ls, rs, ts, bs, tl, tr, bl, br)	wborder(stdscr, ls, rs, ts, bs, tl, tr, bl, br)
1227#define hline(ch, n)		whline(stdscr, ch, (n))
1228#define vline(ch, n)		wvline(stdscr, ch, (n))
1229
1230#define winstr(w, s)		winnstr(w, s, -1)
1231#define winchstr(w, s)		winchnstr(w, s, -1)
1232#define winsstr(w, s)		winsnstr(w, s, -1)
1233
1234#if !NCURSES_OPAQUE
1235#define redrawwin(win)		wredrawln(win, 0, (NCURSES_OK_ADDR(win) ? (win)->_maxy+1 : -1))
1236#endif /* NCURSES_OPAQUE */
1237
1238#define waddstr(win,str)	waddnstr(win,str,-1)
1239#define waddchstr(win,str)	waddchnstr(win,str,-1)
1240
1241/*
1242 * These apply to the first 256 color pairs.
1243 */
1244#define COLOR_PAIR(n)	(NCURSES_BITS((n), 0) & A_COLOR)
1245#define PAIR_NUMBER(a)	(NCURSES_CAST(int,((NCURSES_CAST(unsigned long,(a)) & A_COLOR) >> NCURSES_ATTR_SHIFT)))
1246
1247/*
1248 * pseudo functions for standard screen
1249 */
1250
1251#define addch(ch)		waddch(stdscr,(ch))
1252#define addchnstr(str,n)	waddchnstr(stdscr,(str),(n))
1253#define addchstr(str)		waddchstr(stdscr,(str))
1254#define addnstr(str,n)		waddnstr(stdscr,(str),(n))
1255#define addstr(str)		waddnstr(stdscr,(str),-1)
1256#define attr_get(ap,cp,o)	wattr_get(stdscr,(ap),(cp),(o))
1257#define attr_off(a,o)		wattr_off(stdscr,(a),(o))
1258#define attr_on(a,o)		wattr_on(stdscr,(a),(o))
1259#define attr_set(a,c,o)		wattr_set(stdscr,(a),(c),(o))
1260#define attroff(at)		wattroff(stdscr,(at))
1261#define attron(at)		wattron(stdscr,(at))
1262#define attrset(at)		wattrset(stdscr,(at))
1263#define bkgd(ch)		wbkgd(stdscr,(ch))
1264#define bkgdset(ch)		wbkgdset(stdscr,(ch))
1265#define chgat(n,a,c,o)		wchgat(stdscr,(n),(a),(c),(o))
1266#define clear()			wclear(stdscr)
1267#define clrtobot()		wclrtobot(stdscr)
1268#define clrtoeol()		wclrtoeol(stdscr)
1269#define color_set(c,o)		wcolor_set(stdscr,(c),(o))
1270#define delch()			wdelch(stdscr)
1271#define deleteln()		winsdelln(stdscr,-1)
1272#define echochar(c)		wechochar(stdscr,(c))
1273#define erase()			werase(stdscr)
1274#define getch()			wgetch(stdscr)
1275#define getstr(str)		wgetstr(stdscr,(str))
1276#define inch()			winch(stdscr)
1277#define inchnstr(s,n)		winchnstr(stdscr,(s),(n))
1278#define inchstr(s)		winchstr(stdscr,(s))
1279#define innstr(s,n)		winnstr(stdscr,(s),(n))
1280#define insch(c)		winsch(stdscr,(c))
1281#define insdelln(n)		winsdelln(stdscr,(n))
1282#define insertln()		winsdelln(stdscr,1)
1283#define insnstr(s,n)		winsnstr(stdscr,(s),(n))
1284#define insstr(s)		winsstr(stdscr,(s))
1285#define instr(s)		winstr(stdscr,(s))
1286#define move(y,x)		wmove(stdscr,(y),(x))
1287#define refresh()		wrefresh(stdscr)
1288#define scrl(n)			wscrl(stdscr,(n))
1289#define setscrreg(t,b)		wsetscrreg(stdscr,(t),(b))
1290#define standend()		wstandend(stdscr)
1291#define standout()		wstandout(stdscr)
1292#define timeout(delay)		wtimeout(stdscr,(delay))
1293#define wdeleteln(win)		winsdelln(win,-1)
1294#define winsertln(win)		winsdelln(win,1)
1295
1296/*
1297 * mv functions
1298 */
1299
1300#define mvwaddch(win,y,x,ch)		(wmove((win),(y),(x)) == ERR ? ERR : waddch((win),(ch)))
1301#define mvwaddchnstr(win,y,x,str,n)	(wmove((win),(y),(x)) == ERR ? ERR : waddchnstr((win),(str),(n)))
1302#define mvwaddchstr(win,y,x,str)	(wmove((win),(y),(x)) == ERR ? ERR : waddchnstr((win),(str),-1))
1303#define mvwaddnstr(win,y,x,str,n)	(wmove((win),(y),(x)) == ERR ? ERR : waddnstr((win),(str),(n)))
1304#define mvwaddstr(win,y,x,str)		(wmove((win),(y),(x)) == ERR ? ERR : waddnstr((win),(str),-1))
1305#define mvwchgat(win,y,x,n,a,c,o)	(wmove((win),(y),(x)) == ERR ? ERR : wchgat((win),(n),(a),(c),(o)))
1306#define mvwdelch(win,y,x)		(wmove((win),(y),(x)) == ERR ? ERR : wdelch(win))
1307#define mvwgetch(win,y,x)		(wmove((win),(y),(x)) == ERR ? ERR : wgetch(win))
1308#define mvwgetnstr(win,y,x,str,n)	(wmove((win),(y),(x)) == ERR ? ERR : wgetnstr((win),(str),(n)))
1309#define mvwgetstr(win,y,x,str)		(wmove((win),(y),(x)) == ERR ? ERR : wgetstr((win),(str)))
1310#define mvwhline(win,y,x,c,n)		(wmove((win),(y),(x)) == ERR ? ERR : whline((win),(c),(n)))
1311#define mvwinch(win,y,x)		(wmove((win),(y),(x)) == ERR ? NCURSES_CAST(chtype, ERR) : winch(win))
1312#define mvwinchnstr(win,y,x,s,n)	(wmove((win),(y),(x)) == ERR ? ERR : winchnstr((win),(s),(n)))
1313#define mvwinchstr(win,y,x,s)		(wmove((win),(y),(x)) == ERR ? ERR : winchstr((win),(s)))
1314#define mvwinnstr(win,y,x,s,n)		(wmove((win),(y),(x)) == ERR ? ERR : winnstr((win),(s),(n)))
1315#define mvwinsch(win,y,x,c)		(wmove((win),(y),(x)) == ERR ? ERR : winsch((win),(c)))
1316#define mvwinsnstr(win,y,x,s,n)		(wmove((win),(y),(x)) == ERR ? ERR : winsnstr((win),(s),(n)))
1317#define mvwinsstr(win,y,x,s)		(wmove((win),(y),(x)) == ERR ? ERR : winsstr((win),(s)))
1318#define mvwinstr(win,y,x,s)		(wmove((win),(y),(x)) == ERR ? ERR : winstr((win),(s)))
1319#define mvwvline(win,y,x,c,n)		(wmove((win),(y),(x)) == ERR ? ERR : wvline((win),(c),(n)))
1320
1321#define mvaddch(y,x,ch)			mvwaddch(stdscr,(y),(x),(ch))
1322#define mvaddchnstr(y,x,str,n)		mvwaddchnstr(stdscr,(y),(x),(str),(n))
1323#define mvaddchstr(y,x,str)		mvwaddchstr(stdscr,(y),(x),(str))
1324#define mvaddnstr(y,x,str,n)		mvwaddnstr(stdscr,(y),(x),(str),(n))
1325#define mvaddstr(y,x,str)		mvwaddstr(stdscr,(y),(x),(str))
1326#define mvchgat(y,x,n,a,c,o)		mvwchgat(stdscr,(y),(x),(n),(a),(c),(o))
1327#define mvdelch(y,x)			mvwdelch(stdscr,(y),(x))
1328#define mvgetch(y,x)			mvwgetch(stdscr,(y),(x))
1329#define mvgetnstr(y,x,str,n)		mvwgetnstr(stdscr,(y),(x),(str),(n))
1330#define mvgetstr(y,x,str)		mvwgetstr(stdscr,(y),(x),(str))
1331#define mvhline(y,x,c,n)		mvwhline(stdscr,(y),(x),(c),(n))
1332#define mvinch(y,x)			mvwinch(stdscr,(y),(x))
1333#define mvinchnstr(y,x,s,n)		mvwinchnstr(stdscr,(y),(x),(s),(n))
1334#define mvinchstr(y,x,s)		mvwinchstr(stdscr,(y),(x),(s))
1335#define mvinnstr(y,x,s,n)		mvwinnstr(stdscr,(y),(x),(s),(n))
1336#define mvinsch(y,x,c)			mvwinsch(stdscr,(y),(x),(c))
1337#define mvinsnstr(y,x,s,n)		mvwinsnstr(stdscr,(y),(x),(s),(n))
1338#define mvinsstr(y,x,s)			mvwinsstr(stdscr,(y),(x),(s))
1339#define mvinstr(y,x,s)			mvwinstr(stdscr,(y),(x),(s))
1340#define mvvline(y,x,c,n)		mvwvline(stdscr,(y),(x),(c),(n))
1341
1342/*
1343 * Some wide-character functions can be implemented without the extensions.
1344 */
1345#if !NCURSES_OPAQUE
1346#define getbkgd(win)                    (NCURSES_OK_ADDR(win) ? ((win)->_bkgd) : 0)
1347#endif /* NCURSES_OPAQUE */
1348
1349#define slk_attr_off(a,v)		((v) ? ERR : slk_attroff(a))
1350#define slk_attr_on(a,v)		((v) ? ERR : slk_attron(a))
1351
1352#if !NCURSES_OPAQUE
1353#if NCURSES_WATTR_MACROS
1354#if NCURSES_WIDECHAR && @NCURSES_EXT_COLORS@
1355#define wattr_set(win,a,p,opts) \
1356	(NCURSES_OK_ADDR(win) \
1357	 ? ((void)((win)->_attrs = ((a) & ~A_COLOR), \
1358		   (win)->_color = (opts) ? *(int *)(opts) : (p)), \
1359	    OK) \
1360	 : ERR)
1361#define wattr_get(win,a,p,opts) \
1362	(NCURSES_OK_ADDR(win) \
1363	 ? ((void)(NCURSES_OK_ADDR(a) \
1364		   ? (*(a) = (win)->_attrs) \
1365		   : OK), \
1366	    (void)(NCURSES_OK_ADDR(p) \
1367		   ? (*(p) = (NCURSES_PAIRS_T) (win)->_color) \
1368		   : OK), \
1369	    (void)(NCURSES_OK_ADDR(opts) \
1370		   ? (*(int *)(opts) = (win)->_color) \
1371		   : OK), \
1372	    OK) \
1373	 : ERR)
1374#else /* !(NCURSES_WIDECHAR && NCURSES_EXE_COLORS) */
1375#define wattr_set(win,a,p,opts) \
1376	 (NCURSES_OK_ADDR(win) \
1377	  ? ((void)((win)->_attrs = (((a) & ~A_COLOR) | \
1378				     (attr_t)COLOR_PAIR(p))), \
1379	     OK) \
1380	  : ERR)
1381#define wattr_get(win,a,p,opts) \
1382	(NCURSES_OK_ADDR(win) \
1383	 ? ((void)(NCURSES_OK_ADDR(a) \
1384		   ? (*(a) = (win)->_attrs) \
1385		   : OK), \
1386	    (void)(NCURSES_OK_ADDR(p) \
1387		   ? (*(p) = (NCURSES_PAIRS_T) PAIR_NUMBER((win)->_attrs)) \
1388		   : OK), \
1389	    OK) \
1390	 : ERR)
1391#endif /* (NCURSES_WIDECHAR && NCURSES_EXE_COLORS) */
1392#endif /* NCURSES_WATTR_MACROS */
1393#endif /* NCURSES_OPAQUE */
1394
1395/*
1396 * X/Open curses deprecates SVr4 vwprintw/vwscanw, which are supposed to use
1397 * varargs.h.  It adds new calls vw_printw/vw_scanw, which are supposed to
1398 * use POSIX stdarg.h.  The ncurses versions of vwprintw/vwscanw already
1399 * use stdarg.h, so...
1400 */
1401/* define vw_printw		vwprintw */
1402/* define vw_scanw		vwscanw */
1403
1404/*
1405 * Export fallback function for use in C++ binding.
1406 */
1407#if !@HAVE_VSSCANF@
1408#define vsscanf(a,b,c) _nc_vsscanf(a,b,c)
1409NCURSES_EXPORT(int) vsscanf(const char *, const char *, va_list);
1410#endif
1411
1412/*
1413 * These macros are extensions - not in X/Open Curses.
1414 */
1415#if @NCURSES_EXT_FUNCS@
1416#if !NCURSES_OPAQUE
1417#define is_cleared(win)		(NCURSES_OK_ADDR(win) ? (win)->_clear : FALSE)
1418#define is_idcok(win)		(NCURSES_OK_ADDR(win) ? (win)->_idcok : FALSE)
1419#define is_idlok(win)		(NCURSES_OK_ADDR(win) ? (win)->_idlok : FALSE)
1420#define is_immedok(win)		(NCURSES_OK_ADDR(win) ? (win)->_immed : FALSE)
1421#define is_keypad(win)		(NCURSES_OK_ADDR(win) ? (win)->_use_keypad : FALSE)
1422#define is_leaveok(win)		(NCURSES_OK_ADDR(win) ? (win)->_leaveok : FALSE)
1423#define is_nodelay(win)		(NCURSES_OK_ADDR(win) ? ((win)->_delay == 0) : FALSE)
1424#define is_notimeout(win)	(NCURSES_OK_ADDR(win) ? (win)->_notimeout : FALSE)
1425#define is_pad(win)		(NCURSES_OK_ADDR(win) ? ((win)->_flags & _ISPAD) != 0 : FALSE)
1426#define is_scrollok(win)	(NCURSES_OK_ADDR(win) ? (win)->_scroll : FALSE)
1427#define is_subwin(win)		(NCURSES_OK_ADDR(win) ? ((win)->_flags & _SUBWIN) != 0 : FALSE)
1428#define is_syncok(win)		(NCURSES_OK_ADDR(win) ? (win)->_sync : FALSE)
1429#define wgetdelay(win)		(NCURSES_OK_ADDR(win) ? (win)->_delay : 0)
1430#define wgetparent(win)		(NCURSES_OK_ADDR(win) ? (win)->_parent : 0)
1431#define wgetscrreg(win,t,b)	(NCURSES_OK_ADDR(win) ? (*(t) = (win)->_regtop, *(b) = (win)->_regbottom, OK) : ERR)
1432#endif
1433#endif
1434
1435/*
1436 * X/Open says this returns a bool; SVr4 also checked for out-of-range line.
1437 * The macro provides compatibility:
1438 */
1439#define is_linetouched(w,l) ((!(w) || ((l) > getmaxy(w)) || ((l) < 0)) ? ERR : (is_linetouched)((w),(l)))
1440
1441#endif /* NCURSES_NOMACROS */
1442
1443/*
1444 * Public variables.
1445 *
1446 * Notes:
1447 *	a. ESCDELAY was an undocumented feature under AIX curses.
1448 *	   It gives the ESC expire time in milliseconds.
1449 *	b. ttytype is needed for backward compatibility
1450 */
1451#if NCURSES_REENTRANT
1452
1453NCURSES_WRAPPED_VAR(WINDOW *, curscr);
1454NCURSES_WRAPPED_VAR(WINDOW *, newscr);
1455NCURSES_WRAPPED_VAR(WINDOW *, stdscr);
1456NCURSES_WRAPPED_VAR(char *, ttytype);
1457NCURSES_WRAPPED_VAR(int, COLORS);
1458NCURSES_WRAPPED_VAR(int, COLOR_PAIRS);
1459NCURSES_WRAPPED_VAR(int, COLS);
1460NCURSES_WRAPPED_VAR(int, ESCDELAY);
1461NCURSES_WRAPPED_VAR(int, LINES);
1462NCURSES_WRAPPED_VAR(int, TABSIZE);
1463
1464#define curscr      NCURSES_PUBLIC_VAR(curscr())
1465#define newscr      NCURSES_PUBLIC_VAR(newscr())
1466#define stdscr      NCURSES_PUBLIC_VAR(stdscr())
1467#define ttytype     NCURSES_PUBLIC_VAR(ttytype())
1468#define COLORS      NCURSES_PUBLIC_VAR(COLORS())
1469#define COLOR_PAIRS NCURSES_PUBLIC_VAR(COLOR_PAIRS())
1470#define COLS        NCURSES_PUBLIC_VAR(COLS())
1471#define ESCDELAY    NCURSES_PUBLIC_VAR(ESCDELAY())
1472#define LINES       NCURSES_PUBLIC_VAR(LINES())
1473#define TABSIZE     NCURSES_PUBLIC_VAR(TABSIZE())
1474
1475#else
1476
1477extern NCURSES_EXPORT_VAR(WINDOW *) curscr;
1478extern NCURSES_EXPORT_VAR(WINDOW *) newscr;
1479extern NCURSES_EXPORT_VAR(WINDOW *) stdscr;
1480extern NCURSES_EXPORT_VAR(char) ttytype[];
1481extern NCURSES_EXPORT_VAR(int) COLORS;
1482extern NCURSES_EXPORT_VAR(int) COLOR_PAIRS;
1483extern NCURSES_EXPORT_VAR(int) COLS;
1484extern NCURSES_EXPORT_VAR(int) ESCDELAY;
1485extern NCURSES_EXPORT_VAR(int) LINES;
1486extern NCURSES_EXPORT_VAR(int) TABSIZE;
1487
1488#endif
1489
1490/*
1491 * Pseudo-character tokens outside ASCII range.  The curses wgetch() function
1492 * will return any given one of these only if the corresponding k- capability
1493 * is defined in your terminal's terminfo entry.
1494 *
1495 * Some keys (KEY_A1, etc) are arranged like this:
1496 *	a1     up    a3
1497 *	left   b2    right
1498 *	c1     down  c3
1499 *
1500 * A few key codes do not depend upon the terminfo entry.
1501 */
1502#define KEY_CODE_YES	0400		/* A wchar_t contains a key code */
1503#define KEY_MIN		0401		/* Minimum curses key */
1504#define KEY_BREAK	0401		/* Break key (unreliable) */
1505#define KEY_SRESET	0530		/* Soft (partial) reset (unreliable) */
1506#define KEY_RESET	0531		/* Reset or hard reset (unreliable) */
1507