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