e3d6d08b2d63250a520cc0b6c8877cad4f1a0b4c
[ncurses.git] / doc / html / man / ncurses.3x.html
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
2 <!-- 
3   * t
4   ****************************************************************************
5   * Copyright (c) 1998-2005,2006 Free Software Foundation, Inc.              *
6   *                                                                          *
7   * Permission is hereby granted, free of charge, to any person obtaining a  *
8   * copy of this software and associated documentation files (the            *
9   * "Software"), to deal in the Software without restriction, including      *
10   * without limitation the rights to use, copy, modify, merge, publish,      *
11   * distribute, distribute with modifications, sublicense, and/or sell       *
12   * copies of the Software, and to permit persons to whom the Software is    *
13   * furnished to do so, subject to the following conditions:                 *
14   *                                                                          *
15   * The above copyright notice and this permission notice shall be included  *
16   * in all copies or substantial portions of the Software.                   *
17   *                                                                          *
18   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
19   * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
20   * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
21   * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
22   * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
23   * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
24   * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
25   *                                                                          *
26   * Except as contained in this notice, the name(s) of the above copyright   *
27   * holders shall not be used in advertising or otherwise to promote the     *
28   * sale, use or other dealings in this Software without prior written       *
29   * authorization.                                                           *
30   ****************************************************************************
31   * @Id: ncurses.3x,v 1.82 2006/12/24 14:44:05 tom Exp @
32 -->
33 <HTML>
34 <HEAD>
35 <TITLE>ncurses 3x</TITLE>
36 <link rev=made href="mailto:bug-ncurses@gnu.org">
37 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
38 </HEAD>
39 <BODY>
40 <H1>ncurses 3x</H1>
41 <HR>
42 <PRE>
43 <!-- Manpage converted by man2html 3.0.1 -->
44 <STRONG><A HREF="ncurses.3x.html">ncurses(3x)</A></STRONG>                                                 <STRONG><A HREF="ncurses.3x.html">ncurses(3x)</A></STRONG>
45
46
47
48
49 </PRE>
50 <H2>NAME</H2><PRE>
51        <STRONG>ncurses</STRONG> - CRT screen handling and optimization package
52
53
54 </PRE>
55 <H2>SYNOPSIS</H2><PRE>
56        <STRONG>#include</STRONG> <STRONG>&lt;curses.h&gt;</STRONG>
57
58
59 </PRE>
60 <H2>DESCRIPTION</H2><PRE>
61        The  <STRONG>ncurses</STRONG>  library  routines  give the user a terminal-
62        independent method of updating character screens with rea-
63        sonable   optimization.    This  implementation  is  ``new
64        curses'' (ncurses) and is  the  approved  replacement  for
65        4.4BSD  classic curses, which has been discontinued.  This
66        describes <STRONG>ncurses</STRONG> version 5.6 (patch 20070303).
67
68        The <STRONG>ncurses</STRONG> routines emulate  the  <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>  library  of
69        System V Release 4 UNIX, and the XPG4 curses standard (XSI
70        curses) but the <STRONG>ncurses</STRONG> library is freely  redistributable
71        in source form.  Differences from the SVr4 curses are sum-
72        marized under  the  <STRONG>EXTENSIONS</STRONG>  and  <STRONG>PORTABILITY</STRONG>  sections
73        below  and  described  in  detail in the respective <STRONG>EXTEN-</STRONG>
74        <STRONG>SIONS</STRONG>, <STRONG>PORTABILITY</STRONG> and <STRONG>BUGS</STRONG>  sections  of  individual  man
75        pages.
76
77        A  program  using  these  routines must be linked with the
78        <STRONG>-lncurses</STRONG> option, or (if it has been generated)  with  the
79        debugging  library  <STRONG>-lncurses_g</STRONG>.   (Your system integrator
80        may also have installed these libraries  under  the  names
81        <STRONG>-lcurses</STRONG> and <STRONG>-lcurses_g</STRONG>.)  The ncurses_g library generates
82        trace logs (in a file called 'trace' in the current direc-
83        tory)  that describe curses actions.  See also the section
84        on <STRONG>ALTERNATE</STRONG> <STRONG>CONFIGURATIONS</STRONG>.
85
86        The <STRONG>ncurses</STRONG> package supports: overall screen,  window  and
87        pad manipulation; output to windows and pads; reading ter-
88        minal input; control over terminal and  <STRONG>curses</STRONG>  input  and
89        output  options; environment query routines; color manipu-
90        lation; use of soft label keys; terminfo capabilities; and
91        access to low-level terminal-manipulation routines.
92
93        To initialize the routines, the routine <STRONG>initscr</STRONG> or <STRONG>newterm</STRONG>
94        must be called before any of the other routines that  deal
95        with  windows  and  screens  are used.  The routine <STRONG>endwin</STRONG>
96        must be called before exiting.  To get character-at-a-time
97        input  without  echoing (most interactive, screen oriented
98        programs want this),  the  following  sequence  should  be
99        used:
100
101              <STRONG>initscr();</STRONG> <STRONG>cbreak();</STRONG> <STRONG>noecho();</STRONG>
102
103        Most programs would additionally use the sequence:
104
105              <STRONG>nonl();</STRONG>
106              <STRONG>intrflush(stdscr,</STRONG> <STRONG>FALSE);</STRONG>
107              <STRONG>keypad(stdscr,</STRONG> <STRONG>TRUE);</STRONG>
108
109        Before  a <STRONG>curses</STRONG> program is run, the tab stops of the ter-
110        minal should be set and  its  initialization  strings,  if
111        defined,  must  be  output.  This can be done by executing
112        the <STRONG>tput</STRONG> <STRONG>init</STRONG> command after the shell environment variable
113        <STRONG>TERM</STRONG>  has  been  exported.  <STRONG>tset(1)</STRONG> is usually responsible
114        for doing this.  [See <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG> for further details.]
115
116        The <STRONG>ncurses</STRONG> library permits manipulation  of  data  struc-
117        tures,  called  <EM>windows</EM>,  which  can be thought of as two-
118        dimensional arrays of characters representing all or  part
119        of a CRT screen.  A default window called <STRONG>stdscr</STRONG>, which is
120        the size of the terminal screen, is supplied.  Others  may
121        be created with <STRONG>newwin</STRONG>.
122
123        Note  that  <STRONG>curses</STRONG>  does  not  handle overlapping windows,
124        that's done by the <STRONG><A HREF="panel.3x.html">panel(3x)</A></STRONG> library. This means that  you
125        can either use <STRONG>stdscr</STRONG> or divide the screen into tiled win-
126        dows and not using <STRONG>stdscr</STRONG> at  all.  Mixing  the  two  will
127        result in unpredictable, and undesired, effects.
128
129        Windows are referred to by variables declared as <STRONG>WINDOW</STRONG> <STRONG>*</STRONG>.
130        These  data  structures  are  manipulated  with   routines
131        described  here and elsewhere in the <STRONG>ncurses</STRONG> manual pages.
132        Among those, the most basic routines are <STRONG>move</STRONG>  and  <STRONG>addch</STRONG>.
133        More  general versions of these routines are included with
134        names beginning with <STRONG>w</STRONG>, allowing the  user  to  specify  a
135        window.   The routines not beginning with <STRONG>w</STRONG> affect <STRONG>stdscr</STRONG>.
136
137        After using routines to manipulate a  window,  <STRONG>refresh</STRONG>  is
138        called,  telling <STRONG>curses</STRONG> to make the user's CRT screen look
139        like <STRONG>stdscr</STRONG>.  The characters in a window are  actually  of
140        type  <STRONG>chtype</STRONG>, (character and attribute data) so that other
141        information about the character may also  be  stored  with
142        each character.
143
144        Special  windows  called  <EM>pads</EM>  may  also  be manipulated.
145        These are windows which are not constrained to the size of
146        the  screen and whose contents need not be completely dis-
147        played.  See <STRONG><A HREF="curs_pad.3x.html">curs_pad(3x)</A></STRONG> for more information.
148
149        In addition to drawing characters  on  the  screen,  video
150        attributes  and colors may be supported, causing the char-
151        acters to show up in such modes as underlined, in  reverse
152        video,  or in color on terminals that support such display
153        enhancements.  Line drawing characters may be specified to
154        be  output.   On  input,  <STRONG>curses</STRONG> is also able to translate
155        arrow and function keys  that  transmit  escape  sequences
156        into  single  values.   The video attributes, line drawing
157        characters,  and  input  values  use  names,  defined   in
158        <STRONG>&lt;curses.h&gt;</STRONG>, such as <STRONG>A_REVERSE</STRONG>, <STRONG>ACS_HLINE</STRONG>, and <STRONG>KEY_LEFT</STRONG>.
159
160        If the environment variables <STRONG>LINES</STRONG> and <STRONG>COLUMNS</STRONG> are set, or
161        if the program is executing in a window environment,  line
162        and  column  information  in the environment will override
163        information read by <EM>terminfo</EM>.  This would effect a program
164        running  in an AT&amp;T 630 layer, for example, where the size
165        of a screen is changeable (see <STRONG>ENVIRONMENT</STRONG>).
166
167        If the environment variable <STRONG>TERMINFO</STRONG> is defined, any  pro-
168        gram  using  <STRONG>curses</STRONG> checks for a local terminal definition
169        before checking in the standard place.   For  example,  if
170        <STRONG>TERM</STRONG> is set to <STRONG>att4424</STRONG>, then the compiled terminal defini-
171        tion is found in
172
173              <STRONG>/usr/share/terminfo/a/att4424</STRONG>.
174
175        (The <STRONG>a</STRONG> is copied from the first letter of <STRONG>att4424</STRONG> to avoid
176        creation  of  huge  directories.)  However, if <STRONG>TERMINFO</STRONG> is
177        set to <STRONG>$HOME/myterms</STRONG>, <STRONG>curses</STRONG> first checks
178
179              <STRONG>$HOME/myterms/a/att4424</STRONG>,
180
181        and if that fails, it then checks
182
183              <STRONG>/usr/share/terminfo/a/att4424</STRONG>.
184
185        This is useful for developing experimental definitions  or
186        when write permission in <STRONG>/usr/share/terminfo</STRONG> is not avail-
187        able.
188
189        The integer  variables  <STRONG>LINES</STRONG>  and  <STRONG>COLS</STRONG>  are  defined  in
190        <STRONG>&lt;curses.h&gt;</STRONG>  and will be filled in by <STRONG>initscr</STRONG> with the size
191        of the screen.  The constants <STRONG>TRUE</STRONG> and <STRONG>FALSE</STRONG> have the val-
192        ues <STRONG>1</STRONG> and <STRONG>0</STRONG>, respectively.
193
194        The  <STRONG>curses</STRONG>  routines  also  define  the <STRONG>WINDOW</STRONG> <STRONG>*</STRONG> variable
195        <STRONG>curscr</STRONG> which is used for certain low-level operations like
196        clearing  and  redrawing a screen containing garbage.  The
197        <STRONG>curscr</STRONG> can be used in only a few routines.
198
199    <STRONG>Routine</STRONG> <STRONG>and</STRONG> <STRONG>Argument</STRONG> <STRONG>Names</STRONG>
200        Many <STRONG>curses</STRONG> routines have two or more versions.  The  rou-
201        tines prefixed with <STRONG>w</STRONG> require a window argument.  The rou-
202        tines prefixed with <STRONG>p</STRONG> require a pad argument.  Those with-
203        out a prefix generally use <STRONG>stdscr</STRONG>.
204
205        The routines prefixed with <STRONG>mv</STRONG> require a <EM>y</EM> and <EM>x</EM> coordinate
206        to move to before performing the appropriate action.   The
207        <STRONG>mv</STRONG>  routines  imply  a call to <STRONG>move</STRONG> before the call to the
208        other routine.  The coordinate <EM>y</EM> always refers to the  row
209        (of  the  window), and <EM>x</EM> always refers to the column.  The
210        upper left-hand corner is always (0,0), not (1,1).
211
212        The routines prefixed with <STRONG>mvw</STRONG> take both a window argument
213        and  <EM>x</EM>  and  <EM>y</EM> coordinates.  The window argument is always
214        specified before the coordinates.
215
216        In each case, <EM>win</EM> is the window affected, and <EM>pad</EM>  is  the
217        pad affected; <EM>win</EM> and <EM>pad</EM> are always pointers to type <STRONG>WIN-</STRONG>
218        <STRONG>DOW</STRONG>.
219
220        Option setting routines require a Boolean flag <EM>bf</EM> with the
221        value <STRONG>TRUE</STRONG> or <STRONG>FALSE</STRONG>; <EM>bf</EM> is always of type <STRONG>bool</STRONG>.  The vari-
222        ables <EM>ch</EM> and <EM>attrs</EM> below are always of type  <STRONG>chtype</STRONG>.   The
223        types  <STRONG>WINDOW</STRONG>,  <STRONG>SCREEN</STRONG>,  <STRONG>bool</STRONG>,  and  <STRONG>chtype</STRONG> are defined in
224        <STRONG>&lt;curses.h&gt;</STRONG>.  The type <STRONG>TERMINAL</STRONG>  is  defined  in  <STRONG>&lt;term.h&gt;</STRONG>.
225        All other arguments are integers.
226
227    <STRONG>Routine</STRONG> <STRONG>Name</STRONG> <STRONG>Index</STRONG>
228        The following table lists each <STRONG>curses</STRONG> routine and the name
229        of the manual page on which  it  is  described.   Routines
230        flagged  with  `*'  are ncurses-specific, not described by
231        XPG4 or present in SVr4.
232
233
234               <STRONG>curses</STRONG> Routine Name     Manual Page Name
235               --------------------------------------------
236               COLOR_PAIR              <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>
237               PAIR_NUMBER             <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
238               _nc_tracebits           <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
239               _traceattr              <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
240               _traceattr2             <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
241               _tracechar              <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
242               _tracechtype            <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
243               _tracechtype2           <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
244               _tracedump              <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
245               _tracef                 <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
246               _tracemouse             <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
247
248               add_wch                 <STRONG><A HREF="curs_add_wch.3x.html">curs_add_wch(3x)</A></STRONG>
249               add_wchnstr             <STRONG><A HREF="curs_add_wchstr.3x.html">curs_add_wchstr(3x)</A></STRONG>
250               add_wchstr              <STRONG><A HREF="curs_add_wchstr.3x.html">curs_add_wchstr(3x)</A></STRONG>
251               addch                   <STRONG><A HREF="curs_addch.3x.html">curs_addch(3x)</A></STRONG>
252               addchnstr               <STRONG><A HREF="curs_addchstr.3x.html">curs_addchstr(3x)</A></STRONG>
253               addchstr                <STRONG><A HREF="curs_addchstr.3x.html">curs_addchstr(3x)</A></STRONG>
254               addnstr                 <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
255               addnwstr                <STRONG><A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A></STRONG>
256               addstr                  <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
257               addwstr                 <STRONG><A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A></STRONG>
258               assume_default_colors   <STRONG><A HREF="default_colors.3x.html">default_colors(3x)</A></STRONG>*
259               attr_get                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
260               attr_off                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
261               attr_on                 <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
262               attr_set                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
263               attroff                 <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
264               attron                  <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
265               attrset                 <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
266               baudrate                <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
267               beep                    <STRONG><A HREF="curs_beep.3x.html">curs_beep(3x)</A></STRONG>
268               bkgd                    <STRONG><A HREF="curs_bkgd.3x.html">curs_bkgd(3x)</A></STRONG>
269               bkgdset                 <STRONG><A HREF="curs_bkgd.3x.html">curs_bkgd(3x)</A></STRONG>
270               bkgrnd                  <STRONG><A HREF="curs_bkgrnd.3x.html">curs_bkgrnd(3x)</A></STRONG>
271               bkgrndset               <STRONG><A HREF="curs_bkgrnd.3x.html">curs_bkgrnd(3x)</A></STRONG>
272               border                  <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
273               border_set              <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
274               box                     <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
275               box_set                 <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
276               can_change_color        <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>
277               cbreak                  <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
278               chgat                   <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
279               clear                   <STRONG><A HREF="curs_clear.3x.html">curs_clear(3x)</A></STRONG>
280               clearok                 <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
281               clrtobot                <STRONG><A HREF="curs_clear.3x.html">curs_clear(3x)</A></STRONG>
282               clrtoeol                <STRONG><A HREF="curs_clear.3x.html">curs_clear(3x)</A></STRONG>
283               color_content           <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>
284               color_set               <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
285               copywin                 <STRONG><A HREF="curs_overlay.3x.html">curs_overlay(3x)</A></STRONG>
286               curs_set                <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
287               curses_version          <STRONG><A HREF="curs_extend.3x.html">curs_extend(3x)</A></STRONG>*
288               def_prog_mode           <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
289               def_shell_mode          <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
290               define_key              <STRONG><A HREF="define_key.3x.html">define_key(3x)</A></STRONG>*
291               del_curterm             <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
292               delay_output            <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
293               delch                   <STRONG><A HREF="curs_delch.3x.html">curs_delch(3x)</A></STRONG>
294               deleteln                <STRONG><A HREF="curs_deleteln.3x.html">curs_deleteln(3x)</A></STRONG>
295               delscreen               <STRONG><A HREF="curs_initscr.3x.html">curs_initscr(3x)</A></STRONG>
296               delwin                  <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
297               derwin                  <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
298               doupdate                <STRONG><A HREF="curs_refresh.3x.html">curs_refresh(3x)</A></STRONG>
299               dupwin                  <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
300               echo                    <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
301               echo_wchar              <STRONG><A HREF="curs_add_wch.3x.html">curs_add_wch(3x)</A></STRONG>
302               echochar                <STRONG><A HREF="curs_addch.3x.html">curs_addch(3x)</A></STRONG>
303               endwin                  <STRONG><A HREF="curs_initscr.3x.html">curs_initscr(3x)</A></STRONG>
304               erase                   <STRONG><A HREF="curs_clear.3x.html">curs_clear(3x)</A></STRONG>
305               erasechar               <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
306               erasewchar              <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
307               filter                  <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
308               flash                   <STRONG><A HREF="curs_beep.3x.html">curs_beep(3x)</A></STRONG>
309               flushinp                <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
310               get_wch                 <STRONG><A HREF="curs_get_wch.3x.html">curs_get_wch(3x)</A></STRONG>
311               get_wstr                <STRONG><A HREF="curs_get_wstr.3x.html">curs_get_wstr(3x)</A></STRONG>
312               getbegyx                <STRONG><A HREF="curs_getyx.3x.html">curs_getyx(3x)</A></STRONG>
313
314               getbkgd                 <STRONG><A HREF="curs_bkgd.3x.html">curs_bkgd(3x)</A></STRONG>
315               getbkgrnd               <STRONG><A HREF="curs_bkgrnd.3x.html">curs_bkgrnd(3x)</A></STRONG>
316               getcchar                <STRONG><A HREF="curs_getcchar.3x.html">curs_getcchar(3x)</A></STRONG>
317               getch                   <STRONG><A HREF="curs_getch.3x.html">curs_getch(3x)</A></STRONG>
318               getmaxyx                <STRONG><A HREF="curs_getyx.3x.html">curs_getyx(3x)</A></STRONG>
319               getmouse                <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG>*
320               getn_wstr               <STRONG><A HREF="curs_get_wstr.3x.html">curs_get_wstr(3x)</A></STRONG>
321               getnstr                 <STRONG><A HREF="curs_getstr.3x.html">curs_getstr(3x)</A></STRONG>
322               getparyx                <STRONG><A HREF="curs_getyx.3x.html">curs_getyx(3x)</A></STRONG>
323               getstr                  <STRONG><A HREF="curs_getstr.3x.html">curs_getstr(3x)</A></STRONG>
324               getsyx                  <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
325               getwin                  <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
326               getyx                   <STRONG><A HREF="curs_getyx.3x.html">curs_getyx(3x)</A></STRONG>
327               halfdelay               <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
328               has_colors              <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>
329               has_ic                  <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
330               has_il                  <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
331               has_key                 <STRONG><A HREF="curs_getch.3x.html">curs_getch(3x)</A></STRONG>*
332               hline                   <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
333               hline_set               <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
334               idcok                   <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
335               idlok                   <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
336               immedok                 <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
337               in_wch                  <STRONG><A HREF="curs_in_wch.3x.html">curs_in_wch(3x)</A></STRONG>
338               in_wchnstr              <STRONG><A HREF="curs_in_wchstr.3x.html">curs_in_wchstr(3x)</A></STRONG>
339               in_wchstr               <STRONG><A HREF="curs_in_wchstr.3x.html">curs_in_wchstr(3x)</A></STRONG>
340               inch                    <STRONG><A HREF="curs_inch.3x.html">curs_inch(3x)</A></STRONG>
341               inchnstr                <STRONG><A HREF="curs_inchstr.3x.html">curs_inchstr(3x)</A></STRONG>
342               inchstr                 <STRONG><A HREF="curs_inchstr.3x.html">curs_inchstr(3x)</A></STRONG>
343               init_color              <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>
344               init_pair               <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>
345               initscr                 <STRONG><A HREF="curs_initscr.3x.html">curs_initscr(3x)</A></STRONG>
346               innstr                  <STRONG><A HREF="curs_instr.3x.html">curs_instr(3x)</A></STRONG>
347               innwstr                 <STRONG><A HREF="curs_inwstr.3x.html">curs_inwstr(3x)</A></STRONG>
348               ins_nwstr               <STRONG><A HREF="curs_ins_wstr.3x.html">curs_ins_wstr(3x)</A></STRONG>
349               ins_wch                 <STRONG><A HREF="curs_ins_wch.3x.html">curs_ins_wch(3x)</A></STRONG>
350               ins_wstr                <STRONG><A HREF="curs_ins_wstr.3x.html">curs_ins_wstr(3x)</A></STRONG>
351               insch                   <STRONG><A HREF="curs_insch.3x.html">curs_insch(3x)</A></STRONG>
352               insdelln                <STRONG><A HREF="curs_deleteln.3x.html">curs_deleteln(3x)</A></STRONG>
353               insertln                <STRONG><A HREF="curs_deleteln.3x.html">curs_deleteln(3x)</A></STRONG>
354               insnstr                 <STRONG><A HREF="curs_insstr.3x.html">curs_insstr(3x)</A></STRONG>
355               insstr                  <STRONG><A HREF="curs_insstr.3x.html">curs_insstr(3x)</A></STRONG>
356               instr                   <STRONG><A HREF="curs_instr.3x.html">curs_instr(3x)</A></STRONG>
357               intrflush               <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
358               inwstr                  <STRONG><A HREF="curs_inwstr.3x.html">curs_inwstr(3x)</A></STRONG>
359               is_linetouched          <STRONG><A HREF="curs_touch.3x.html">curs_touch(3x)</A></STRONG>
360               is_wintouched           <STRONG><A HREF="curs_touch.3x.html">curs_touch(3x)</A></STRONG>
361               isendwin                <STRONG><A HREF="curs_initscr.3x.html">curs_initscr(3x)</A></STRONG>
362               key_defined             <STRONG><A HREF="key_defined.3x.html">key_defined(3x)</A></STRONG>*
363               key_name                <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
364               keybound                <STRONG><A HREF="keybound.3x.html">keybound(3x)</A></STRONG>*
365               keyname                 <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
366               keyok                   <STRONG><A HREF="keyok.3x.html">keyok(3x)</A></STRONG>*
367               keypad                  <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
368               killchar                <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
369               killwchar               <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
370               leaveok                 <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
371               longname                <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
372               mcprint                 <STRONG><A HREF="curs_print.3x.html">curs_print(3x)</A></STRONG>*
373               meta                    <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
374               mouse_trafo             <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG>*
375               mouseinterval           <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG>*
376               mousemask               <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG>*
377               move                    <STRONG><A HREF="curs_move.3x.html">curs_move(3x)</A></STRONG>
378               mvadd_wch               <STRONG><A HREF="curs_add_wch.3x.html">curs_add_wch(3x)</A></STRONG>
379
380               mvadd_wchnstr           <STRONG><A HREF="curs_add_wchstr.3x.html">curs_add_wchstr(3x)</A></STRONG>
381               mvadd_wchstr            <STRONG><A HREF="curs_add_wchstr.3x.html">curs_add_wchstr(3x)</A></STRONG>
382               mvaddch                 <STRONG><A HREF="curs_addch.3x.html">curs_addch(3x)</A></STRONG>
383               mvaddchnstr             <STRONG><A HREF="curs_addchstr.3x.html">curs_addchstr(3x)</A></STRONG>
384               mvaddchstr              <STRONG><A HREF="curs_addchstr.3x.html">curs_addchstr(3x)</A></STRONG>
385               mvaddnstr               <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
386               mvaddnwstr              <STRONG><A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A></STRONG>
387               mvaddstr                <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
388               mvaddwstr               <STRONG><A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A></STRONG>
389               mvchgat                 <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
390               mvcur                   <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
391               mvdelch                 <STRONG><A HREF="curs_delch.3x.html">curs_delch(3x)</A></STRONG>
392               mvderwin                <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
393               mvget_wch               <STRONG><A HREF="curs_get_wch.3x.html">curs_get_wch(3x)</A></STRONG>
394               mvget_wstr              <STRONG><A HREF="curs_get_wstr.3x.html">curs_get_wstr(3x)</A></STRONG>
395               mvgetch                 <STRONG><A HREF="curs_getch.3x.html">curs_getch(3x)</A></STRONG>
396               mvgetn_wstr             <STRONG><A HREF="curs_get_wstr.3x.html">curs_get_wstr(3x)</A></STRONG>
397               mvgetnstr               <STRONG><A HREF="curs_getstr.3x.html">curs_getstr(3x)</A></STRONG>
398               mvgetstr                <STRONG><A HREF="curs_getstr.3x.html">curs_getstr(3x)</A></STRONG>
399               mvhline                 <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
400               mvhline_set             <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
401               mvin_wch                <STRONG><A HREF="curs_in_wch.3x.html">curs_in_wch(3x)</A></STRONG>
402               mvin_wchnstr            <STRONG><A HREF="curs_in_wchstr.3x.html">curs_in_wchstr(3x)</A></STRONG>
403               mvin_wchstr             <STRONG><A HREF="curs_in_wchstr.3x.html">curs_in_wchstr(3x)</A></STRONG>
404               mvinch                  <STRONG><A HREF="curs_inch.3x.html">curs_inch(3x)</A></STRONG>
405               mvinchnstr              <STRONG><A HREF="curs_inchstr.3x.html">curs_inchstr(3x)</A></STRONG>
406               mvinchstr               <STRONG><A HREF="curs_inchstr.3x.html">curs_inchstr(3x)</A></STRONG>
407               mvinnstr                <STRONG><A HREF="curs_instr.3x.html">curs_instr(3x)</A></STRONG>
408               mvinnwstr               <STRONG><A HREF="curs_inwstr.3x.html">curs_inwstr(3x)</A></STRONG>
409               mvins_nwstr             <STRONG><A HREF="curs_ins_wstr.3x.html">curs_ins_wstr(3x)</A></STRONG>
410               mvins_wch               <STRONG><A HREF="curs_ins_wch.3x.html">curs_ins_wch(3x)</A></STRONG>
411               mvins_wstr              <STRONG><A HREF="curs_ins_wstr.3x.html">curs_ins_wstr(3x)</A></STRONG>
412               mvinsch                 <STRONG><A HREF="curs_insch.3x.html">curs_insch(3x)</A></STRONG>
413               mvinsnstr               <STRONG><A HREF="curs_insstr.3x.html">curs_insstr(3x)</A></STRONG>
414               mvinsstr                <STRONG><A HREF="curs_insstr.3x.html">curs_insstr(3x)</A></STRONG>
415               mvinstr                 <STRONG><A HREF="curs_instr.3x.html">curs_instr(3x)</A></STRONG>
416               mvinwstr                <STRONG><A HREF="curs_inwstr.3x.html">curs_inwstr(3x)</A></STRONG>
417               mvprintw                <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG>
418               mvscanw                 <STRONG><A HREF="curs_scanw.3x.html">curs_scanw(3x)</A></STRONG>
419               mvvline                 <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
420               mvvline_set             <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
421               mvwadd_wch              <STRONG><A HREF="curs_add_wch.3x.html">curs_add_wch(3x)</A></STRONG>
422               mvwadd_wchnstr          <STRONG><A HREF="curs_add_wchstr.3x.html">curs_add_wchstr(3x)</A></STRONG>
423               mvwadd_wchstr           <STRONG><A HREF="curs_add_wchstr.3x.html">curs_add_wchstr(3x)</A></STRONG>
424               mvwaddch                <STRONG><A HREF="curs_addch.3x.html">curs_addch(3x)</A></STRONG>
425               mvwaddchnstr            <STRONG><A HREF="curs_addchstr.3x.html">curs_addchstr(3x)</A></STRONG>
426               mvwaddchstr             <STRONG><A HREF="curs_addchstr.3x.html">curs_addchstr(3x)</A></STRONG>
427               mvwaddnstr              <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
428               mvwaddnwstr             <STRONG><A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A></STRONG>
429               mvwaddstr               <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
430               mvwaddwstr              <STRONG><A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A></STRONG>
431               mvwchgat                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
432               mvwdelch                <STRONG><A HREF="curs_delch.3x.html">curs_delch(3x)</A></STRONG>
433               mvwget_wch              <STRONG><A HREF="curs_get_wch.3x.html">curs_get_wch(3x)</A></STRONG>
434               mvwget_wstr             <STRONG><A HREF="curs_get_wstr.3x.html">curs_get_wstr(3x)</A></STRONG>
435               mvwgetch                <STRONG><A HREF="curs_getch.3x.html">curs_getch(3x)</A></STRONG>
436               mvwgetn_wstr            <STRONG><A HREF="curs_get_wstr.3x.html">curs_get_wstr(3x)</A></STRONG>
437               mvwgetnstr              <STRONG><A HREF="curs_getstr.3x.html">curs_getstr(3x)</A></STRONG>
438               mvwgetstr               <STRONG><A HREF="curs_getstr.3x.html">curs_getstr(3x)</A></STRONG>
439               mvwhline                <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
440               mvwhline_set            <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
441               mvwin                   <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
442               mvwin_wch               <STRONG><A HREF="curs_in_wch.3x.html">curs_in_wch(3x)</A></STRONG>
443               mvwin_wchnstr           <STRONG><A HREF="curs_in_wchstr.3x.html">curs_in_wchstr(3x)</A></STRONG>
444               mvwin_wchstr            <STRONG><A HREF="curs_in_wchstr.3x.html">curs_in_wchstr(3x)</A></STRONG>
445
446               mvwinch                 <STRONG><A HREF="curs_inch.3x.html">curs_inch(3x)</A></STRONG>
447               mvwinchnstr             <STRONG><A HREF="curs_inchstr.3x.html">curs_inchstr(3x)</A></STRONG>
448               mvwinchstr              <STRONG><A HREF="curs_inchstr.3x.html">curs_inchstr(3x)</A></STRONG>
449               mvwinnstr               <STRONG><A HREF="curs_instr.3x.html">curs_instr(3x)</A></STRONG>
450               mvwinnwstr              <STRONG><A HREF="curs_inwstr.3x.html">curs_inwstr(3x)</A></STRONG>
451               mvwins_nwstr            <STRONG><A HREF="curs_ins_wstr.3x.html">curs_ins_wstr(3x)</A></STRONG>
452               mvwins_wch              <STRONG><A HREF="curs_ins_wch.3x.html">curs_ins_wch(3x)</A></STRONG>
453               mvwins_wstr             <STRONG><A HREF="curs_ins_wstr.3x.html">curs_ins_wstr(3x)</A></STRONG>
454               mvwinsch                <STRONG><A HREF="curs_insch.3x.html">curs_insch(3x)</A></STRONG>
455               mvwinsnstr              <STRONG><A HREF="curs_insstr.3x.html">curs_insstr(3x)</A></STRONG>
456               mvwinsstr               <STRONG><A HREF="curs_insstr.3x.html">curs_insstr(3x)</A></STRONG>
457               mvwinstr                <STRONG><A HREF="curs_instr.3x.html">curs_instr(3x)</A></STRONG>
458               mvwinwstr               <STRONG><A HREF="curs_inwstr.3x.html">curs_inwstr(3x)</A></STRONG>
459               mvwprintw               <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG>
460               mvwscanw                <STRONG><A HREF="curs_scanw.3x.html">curs_scanw(3x)</A></STRONG>
461               mvwvline                <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
462               mvwvline_set            <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
463               napms                   <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
464               newpad                  <STRONG><A HREF="curs_pad.3x.html">curs_pad(3x)</A></STRONG>
465               newterm                 <STRONG><A HREF="curs_initscr.3x.html">curs_initscr(3x)</A></STRONG>
466               newwin                  <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
467               nl                      <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
468               nocbreak                <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
469               nodelay                 <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
470               noecho                  <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
471               nonl                    <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
472               noqiflush               <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
473               noraw                   <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
474               notimeout               <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
475               overlay                 <STRONG><A HREF="curs_overlay.3x.html">curs_overlay(3x)</A></STRONG>
476               overwrite               <STRONG><A HREF="curs_overlay.3x.html">curs_overlay(3x)</A></STRONG>
477               pair_content            <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>
478               pechochar               <STRONG><A HREF="curs_pad.3x.html">curs_pad(3x)</A></STRONG>
479               pnoutrefresh            <STRONG><A HREF="curs_pad.3x.html">curs_pad(3x)</A></STRONG>
480               prefresh                <STRONG><A HREF="curs_pad.3x.html">curs_pad(3x)</A></STRONG>
481               printw                  <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG>
482               putp                    <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
483               putwin                  <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
484               qiflush                 <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
485               raw                     <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
486               redrawwin               <STRONG><A HREF="curs_refresh.3x.html">curs_refresh(3x)</A></STRONG>
487               refresh                 <STRONG><A HREF="curs_refresh.3x.html">curs_refresh(3x)</A></STRONG>
488               reset_prog_mode         <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
489               reset_shell_mode        <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
490               resetty                 <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
491               resizeterm              <STRONG><A HREF="resizeterm.3x.html">resizeterm(3x)</A></STRONG>*
492               restartterm             <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
493               ripoffline              <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
494               savetty                 <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
495               scanw                   <STRONG><A HREF="curs_scanw.3x.html">curs_scanw(3x)</A></STRONG>
496               scr_dump                <STRONG><A HREF="curs_scr_dump.3x.html">curs_scr_dump(3x)</A></STRONG>
497               scr_init                <STRONG><A HREF="curs_scr_dump.3x.html">curs_scr_dump(3x)</A></STRONG>
498               scr_restore             <STRONG><A HREF="curs_scr_dump.3x.html">curs_scr_dump(3x)</A></STRONG>
499               scr_set                 <STRONG><A HREF="curs_scr_dump.3x.html">curs_scr_dump(3x)</A></STRONG>
500               scrl                    <STRONG><A HREF="curs_scroll.3x.html">curs_scroll(3x)</A></STRONG>
501               scroll                  <STRONG><A HREF="curs_scroll.3x.html">curs_scroll(3x)</A></STRONG>
502               scrollok                <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
503               set_curterm             <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
504               set_term                <STRONG><A HREF="curs_initscr.3x.html">curs_initscr(3x)</A></STRONG>
505               setcchar                <STRONG><A HREF="curs_getcchar.3x.html">curs_getcchar(3x)</A></STRONG>
506               setscrreg               <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
507               setsyx                  <STRONG><A HREF="curs_kernel.3x.html">curs_kernel(3x)</A></STRONG>
508               setterm                 <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
509               setupterm               <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
510               slk_attr                <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>*
511
512               slk_attr_off            <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
513               slk_attr_on             <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
514               slk_attr_set            <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
515               slk_attroff             <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
516               slk_attron              <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
517               slk_attrset             <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
518               slk_clear               <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
519               slk_color               <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
520               slk_init                <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
521               slk_label               <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
522               slk_noutrefresh         <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
523               slk_refresh             <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
524               slk_restore             <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
525               slk_set                 <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
526               slk_touch               <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>
527               standend                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
528               standout                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
529               start_color             <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>
530               subpad                  <STRONG><A HREF="curs_pad.3x.html">curs_pad(3x)</A></STRONG>
531               subwin                  <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
532               syncok                  <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
533               term_attrs              <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
534               termattrs               <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
535               termname                <STRONG><A HREF="curs_termattrs.3x.html">curs_termattrs(3x)</A></STRONG>
536               tgetent                 <STRONG><A HREF="curs_termcap.3x.html">curs_termcap(3x)</A></STRONG>
537               tgetflag                <STRONG><A HREF="curs_termcap.3x.html">curs_termcap(3x)</A></STRONG>
538               tgetnum                 <STRONG><A HREF="curs_termcap.3x.html">curs_termcap(3x)</A></STRONG>
539               tgetstr                 <STRONG><A HREF="curs_termcap.3x.html">curs_termcap(3x)</A></STRONG>
540               tgoto                   <STRONG><A HREF="curs_termcap.3x.html">curs_termcap(3x)</A></STRONG>
541               tigetflag               <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
542               tigetnum                <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
543               tigetstr                <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
544               timeout                 <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
545               touchline               <STRONG><A HREF="curs_touch.3x.html">curs_touch(3x)</A></STRONG>
546               touchwin                <STRONG><A HREF="curs_touch.3x.html">curs_touch(3x)</A></STRONG>
547               tparm                   <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
548               tputs                   <STRONG><A HREF="curs_termcap.3x.html">curs_termcap(3x)</A></STRONG>
549               tputs                   <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
550               trace                   <STRONG><A HREF="curs_trace.3x.html">curs_trace(3x)</A></STRONG>*
551               typeahead               <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
552               unctrl                  <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
553               unget_wch               <STRONG><A HREF="curs_get_wch.3x.html">curs_get_wch(3x)</A></STRONG>
554               ungetch                 <STRONG><A HREF="curs_getch.3x.html">curs_getch(3x)</A></STRONG>
555               ungetmouse              <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG>*
556               untouchwin              <STRONG><A HREF="curs_touch.3x.html">curs_touch(3x)</A></STRONG>
557               use_default_colors      <STRONG><A HREF="default_colors.3x.html">default_colors(3x)</A></STRONG>*
558               use_env                 <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
559               use_extended_names      <STRONG><A HREF="curs_extend.3x.html">curs_extend(3x)</A></STRONG>*
560               vid_attr                <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
561               vid_puts                <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
562               vidattr                 <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
563               vidputs                 <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>
564               vline                   <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
565               vline_set               <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
566               vw_printw               <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG>
567               vw_scanw                <STRONG><A HREF="curs_scanw.3x.html">curs_scanw(3x)</A></STRONG>
568               vwprintw                <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG>
569               vwscanw                 <STRONG><A HREF="curs_scanw.3x.html">curs_scanw(3x)</A></STRONG>
570               wadd_wch                <STRONG><A HREF="curs_add_wch.3x.html">curs_add_wch(3x)</A></STRONG>
571               wadd_wchnstr            <STRONG><A HREF="curs_add_wchstr.3x.html">curs_add_wchstr(3x)</A></STRONG>
572               wadd_wchstr             <STRONG><A HREF="curs_add_wchstr.3x.html">curs_add_wchstr(3x)</A></STRONG>
573               waddch                  <STRONG><A HREF="curs_addch.3x.html">curs_addch(3x)</A></STRONG>
574               waddchnstr              <STRONG><A HREF="curs_addchstr.3x.html">curs_addchstr(3x)</A></STRONG>
575               waddchstr               <STRONG><A HREF="curs_addchstr.3x.html">curs_addchstr(3x)</A></STRONG>
576               waddnstr                <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
577
578               waddnwstr               <STRONG><A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A></STRONG>
579               waddstr                 <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
580               waddwstr                <STRONG><A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A></STRONG>
581               wattr_get               <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
582               wattr_off               <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
583               wattr_on                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
584               wattr_set               <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
585               wattroff                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
586               wattron                 <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
587               wattrset                <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
588               wbkgd                   <STRONG><A HREF="curs_bkgd.3x.html">curs_bkgd(3x)</A></STRONG>
589               wbkgdset                <STRONG><A HREF="curs_bkgd.3x.html">curs_bkgd(3x)</A></STRONG>
590               wbkgrnd                 <STRONG><A HREF="curs_bkgrnd.3x.html">curs_bkgrnd(3x)</A></STRONG>
591               wbkgrndset              <STRONG><A HREF="curs_bkgrnd.3x.html">curs_bkgrnd(3x)</A></STRONG>
592               wborder                 <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
593               wborder_set             <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
594               wchgat                  <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
595               wclear                  <STRONG><A HREF="curs_clear.3x.html">curs_clear(3x)</A></STRONG>
596               wclrtobot               <STRONG><A HREF="curs_clear.3x.html">curs_clear(3x)</A></STRONG>
597               wclrtoeol               <STRONG><A HREF="curs_clear.3x.html">curs_clear(3x)</A></STRONG>
598               wcolor_set              <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
599               wcursyncup              <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
600               wdelch                  <STRONG><A HREF="curs_delch.3x.html">curs_delch(3x)</A></STRONG>
601               wdeleteln               <STRONG><A HREF="curs_deleteln.3x.html">curs_deleteln(3x)</A></STRONG>
602               wecho_wchar             <STRONG><A HREF="curs_add_wch.3x.html">curs_add_wch(3x)</A></STRONG>
603               wechochar               <STRONG><A HREF="curs_addch.3x.html">curs_addch(3x)</A></STRONG>
604               wenclose                <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG>*
605               werase                  <STRONG><A HREF="curs_clear.3x.html">curs_clear(3x)</A></STRONG>
606               wget_wch                <STRONG><A HREF="curs_get_wch.3x.html">curs_get_wch(3x)</A></STRONG>
607               wget_wstr               <STRONG><A HREF="curs_get_wstr.3x.html">curs_get_wstr(3x)</A></STRONG>
608               wgetbkgrnd              <STRONG><A HREF="curs_bkgrnd.3x.html">curs_bkgrnd(3x)</A></STRONG>
609               wgetch                  <STRONG><A HREF="curs_getch.3x.html">curs_getch(3x)</A></STRONG>
610               wgetn_wstr              <STRONG><A HREF="curs_get_wstr.3x.html">curs_get_wstr(3x)</A></STRONG>
611               wgetnstr                <STRONG><A HREF="curs_getstr.3x.html">curs_getstr(3x)</A></STRONG>
612               wgetstr                 <STRONG><A HREF="curs_getstr.3x.html">curs_getstr(3x)</A></STRONG>
613               whline                  <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
614               whline_set              <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
615               win_wch                 <STRONG><A HREF="curs_in_wch.3x.html">curs_in_wch(3x)</A></STRONG>
616               win_wchnstr             <STRONG><A HREF="curs_in_wchstr.3x.html">curs_in_wchstr(3x)</A></STRONG>
617               win_wchstr              <STRONG><A HREF="curs_in_wchstr.3x.html">curs_in_wchstr(3x)</A></STRONG>
618               winch                   <STRONG><A HREF="curs_inch.3x.html">curs_inch(3x)</A></STRONG>
619               winchnstr               <STRONG><A HREF="curs_inchstr.3x.html">curs_inchstr(3x)</A></STRONG>
620               winchstr                <STRONG><A HREF="curs_inchstr.3x.html">curs_inchstr(3x)</A></STRONG>
621               winnstr                 <STRONG><A HREF="curs_instr.3x.html">curs_instr(3x)</A></STRONG>
622               winnwstr                <STRONG><A HREF="curs_inwstr.3x.html">curs_inwstr(3x)</A></STRONG>
623               wins_nwstr              <STRONG><A HREF="curs_ins_wstr.3x.html">curs_ins_wstr(3x)</A></STRONG>
624               wins_wch                <STRONG><A HREF="curs_ins_wch.3x.html">curs_ins_wch(3x)</A></STRONG>
625               wins_wstr               <STRONG><A HREF="curs_ins_wstr.3x.html">curs_ins_wstr(3x)</A></STRONG>
626               winsch                  <STRONG><A HREF="curs_insch.3x.html">curs_insch(3x)</A></STRONG>
627               winsdelln               <STRONG><A HREF="curs_deleteln.3x.html">curs_deleteln(3x)</A></STRONG>
628               winsertln               <STRONG><A HREF="curs_deleteln.3x.html">curs_deleteln(3x)</A></STRONG>
629               winsnstr                <STRONG><A HREF="curs_insstr.3x.html">curs_insstr(3x)</A></STRONG>
630               winsstr                 <STRONG><A HREF="curs_insstr.3x.html">curs_insstr(3x)</A></STRONG>
631               winstr                  <STRONG><A HREF="curs_instr.3x.html">curs_instr(3x)</A></STRONG>
632               winwstr                 <STRONG><A HREF="curs_inwstr.3x.html">curs_inwstr(3x)</A></STRONG>
633               wmouse_trafo            <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG>*
634               wmove                   <STRONG><A HREF="curs_move.3x.html">curs_move(3x)</A></STRONG>
635               wnoutrefresh            <STRONG><A HREF="curs_refresh.3x.html">curs_refresh(3x)</A></STRONG>
636               wprintw                 <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG>
637               wredrawln               <STRONG><A HREF="curs_refresh.3x.html">curs_refresh(3x)</A></STRONG>
638               wrefresh                <STRONG><A HREF="curs_refresh.3x.html">curs_refresh(3x)</A></STRONG>
639               wresize                 <STRONG><A HREF="wresize.3x.html">wresize(3x)</A></STRONG>*
640               wscanw                  <STRONG><A HREF="curs_scanw.3x.html">curs_scanw(3x)</A></STRONG>
641               wscrl                   <STRONG><A HREF="curs_scroll.3x.html">curs_scroll(3x)</A></STRONG>
642               wsetscrreg              <STRONG><A HREF="curs_outopts.3x.html">curs_outopts(3x)</A></STRONG>
643
644               wstandend               <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
645               wstandout               <STRONG><A HREF="curs_attr.3x.html">curs_attr(3x)</A></STRONG>
646               wsyncdown               <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
647               wsyncup                 <STRONG><A HREF="curs_window.3x.html">curs_window(3x)</A></STRONG>
648               wtimeout                <STRONG><A HREF="curs_inopts.3x.html">curs_inopts(3x)</A></STRONG>
649               wtouchln                <STRONG><A HREF="curs_touch.3x.html">curs_touch(3x)</A></STRONG>
650               wunctrl                 <STRONG><A HREF="curs_util.3x.html">curs_util(3x)</A></STRONG>
651               wvline                  <STRONG><A HREF="curs_border.3x.html">curs_border(3x)</A></STRONG>
652               wvline_set              <STRONG><A HREF="curs_border_set.3x.html">curs_border_set(3x)</A></STRONG>
653
654
655 </PRE>
656 <H2>RETURN VALUE</H2><PRE>
657        Routines that return an integer return  <STRONG>ERR</STRONG>  upon  failure
658        and  an  integer value other than <STRONG>ERR</STRONG> upon successful com-
659        pletion, unless otherwise noted in  the  routine  descrip-
660        tions.
661
662        All  macros  return  the  value  of  the <STRONG>w</STRONG> version, except
663        <STRONG>setscrreg</STRONG>, <STRONG>wsetscrreg</STRONG>, <STRONG>getyx</STRONG>, <STRONG>getbegyx</STRONG>, and <STRONG>getmaxyx</STRONG>.  The
664        return  values  of <STRONG>setscrreg</STRONG>, <STRONG>wsetscrreg</STRONG>, <STRONG>getyx</STRONG>, <STRONG>getbegyx</STRONG>,
665        and <STRONG>getmaxyx</STRONG> are undefined (i.e., these should not be used
666        as the right-hand side of assignment statements).
667
668        Routines that return pointers return <STRONG>NULL</STRONG> on error.
669
670
671 </PRE>
672 <H2>ENVIRONMENT</H2><PRE>
673        The following environment symbols are useful for customiz-
674        ing the runtime behavior of the <STRONG>ncurses</STRONG> library.  The most
675        important ones have been already discussed in detail.
676
677        BAUDRATE
678             The  debugging library checks this environment symbol
679             when the application has redirected output to a file.
680             The  symbol's numeric value is used for the baudrate.
681             If no value is found, <STRONG>ncurses</STRONG> uses 9600.  This allows
682             testers  to construct repeatable test-cases that take
683             into account costs that depend on baudrate.
684
685        CC   When set, change occurrences of the command_character
686             (i.e.,  the  <STRONG>cmdch</STRONG> capability) of the loaded terminfo
687             entries to the value of this symbol.  Very  few  ter-
688             minfo entries provide this feature.
689
690        COLUMNS
691             Specify  the  width  of  the  screen  in  characters.
692             Applications running in a windowing environment  usu-
693             ally  are  able  to obtain the width of the window in
694             which they are executing.   If  neither  the  <STRONG>COLUMNS</STRONG>
695             value  nor  the  terminal's screen size is available,
696             <STRONG>ncurses</STRONG> uses the size which may be specified  in  the
697             terminfo database (i.e., the <STRONG>cols</STRONG> capability).
698
699             It  is  important that your application use a correct
700             size for the screen.  This  is  not  always  possible
701             because  your  application  may  be running on a host
702             which does not honor NAWS (Negotiations About  Window
703             Size),  or  because  you  are  temporarily running as
704             another user.  However, setting <STRONG>COLUMNS</STRONG> and/or  <STRONG>LINES</STRONG>
705             overrides  the  library's  use  of  the  screen  size
706             obtained from the operating system.
707
708             Either <STRONG>COLUMNS</STRONG> or  <STRONG>LINES</STRONG>  symbols  may  be  specified
709             independently.   This  is mainly useful to circumvent
710             legacy misfeatures of  terminal  descriptions,  e.g.,
711             xterm which commonly specifies a 65 line screen.  For
712             best results, <STRONG>lines</STRONG> and <STRONG>cols</STRONG> should not be  specified
713             in a terminal description for terminals which are run
714             as emulations.
715
716             Use the <STRONG>use_env</STRONG> function to disable all use of exter-
717             nal environment (including system calls) to determine
718             the screen size.
719
720        ESCDELAY
721             Specifies the total time, in milliseconds, for  which
722             ncurses  will  await  a  character  sequence, e.g., a
723             function key.  The default value, 1000  milliseconds,
724             is enough for most uses.  However, it is made a vari-
725             able to accommodate unusual applications.
726
727             The most common instance where you may wish to change
728             this  value is to work with slow hosts, e.g., running
729             on a network.  If the  host  cannot  read  characters
730             rapidly  enough,  it  will have the same effect as if
731             the terminal did not send characters rapidly  enough.
732             The library will still see a timeout.
733
734             Note  that xterm mouse events are built up from char-
735             acter sequences received from  the  xterm.   If  your
736             application makes heavy use of multiple-clicking, you
737             may wish to lengthen this default value  because  the
738             timeout  applies to the composed multi-click event as
739             well as the individual clicks.
740
741             In addition to the environment variable, this  imple-
742             mentation  provides  a  global variable with the same
743             name.  Portable applications should not rely upon the
744             presence  of ESCDELAY in either form, but setting the
745             environment variable rather than the global  variable
746             does  not  create problems when compiling an applica-
747             tion.
748
749        HOME Tells <STRONG>ncurses</STRONG> where your home directory is.  That  is
750             where  it  may  read  and  write  auxiliary  terminal
751             descriptions:
752
753             $HOME/.termcap
754             $HOME/.terminfo
755
756        LINES
757             Like COLUMNS, specify the height  of  the  screen  in
758             characters.   See COLUMNS for a detailed description.
759
760        MOUSE_BUTTONS_123
761             This applies only to the OS/2 EMX port.  It specifies
762             the  order  of  buttons on the mouse.  OS/2 numbers a
763             3-button mouse inconsistently from other platforms:
764
765             1 = left
766             2 = right
767             3 = middle.
768
769             This symbol lets you customize the mouse.  The symbol
770             must  be three numeric digits 1-3 in any order, e.g.,
771             123 or 321.  If it is  not  specified,  <STRONG>ncurses</STRONG>  uses
772             132.
773
774        NCURSES_ASSUMED_COLORS
775             Override  the  compiled-in assumption that the termi-
776             nal's  default   colors   are   white-on-black   (see
777             <STRONG><A HREF="default_colors.3x.html">default_colors(3x)</A></STRONG>).   You may set the foreground and
778             background color values with this  environment  vari-
779             able     by     proving     a     2-element     list:
780             foreground,background.  For example, to tell  ncurses
781             to  not assume anything about the colors, set this to
782             "-1,-1".  To make it green-on-black, set it to "2,0".
783             Any positive value from zero to the terminfo <STRONG>max_col-</STRONG>
784             <STRONG>ors</STRONG> value is allowed.
785
786        NCURSES_NO_HARD_TABS
787             <STRONG>Ncurses</STRONG> may use tabs as part of the  cursor  movement
788             optimization.   In  some  cases, your terminal driver
789             may not handle these properly.  Set this  environment
790             variable to disable the feature.  You can also adjust
791             your <STRONG>stty</STRONG> settings to avoid the problem.
792
793        NCURSES_NO_MAGIC_COOKIES
794             Some  terminals  use  a  magic-cookie  feature  which
795             requires  special  handling  to make highlighting and
796             other video attributes  display  properly.   You  can
797             suppress  the  highlighting entirely for these termi-
798             nals by setting this environment variable.
799
800        NCURSES_NO_PADDING
801             Most of the terminal  descriptions  in  the  terminfo
802             database  are  written for real "hardware" terminals.
803             Many people use terminal emulators  which  run  in  a
804             windowing  environment  and use curses-based applica-
805             tions.  Terminal emulators can duplicate all  of  the
806             important aspects of a hardware terminal, but they do
807             not have the same limitations.  The chief  limitation
808             of  a  hardware  terminal from the standpoint of your
809             application is the management of dataflow, i.e., tim-
810             ing.  Unless a hardware terminal is interfaced into a
811             terminal concentrator (which does flow  control),  it
812             (or  your application) must manage dataflow, prevent-
813             ing overruns.  The  cheapest  solution  (no  hardware
814             cost) is for your program to do this by pausing after
815             operations that the terminal  does  slowly,  such  as
816             clearing the display.
817
818             As  a  result,  many terminal descriptions (including
819             the vt100) have delay times embedded.  You  may  wish
820             to  use  these  descriptions, but not want to pay the
821             performance penalty.
822
823             Set the NCURSES_NO_PADDING symbol to disable all  but
824             mandatory  padding.   Mandatory  padding is used as a
825             part of special control sequences such as <EM>flash</EM>.
826
827        NCURSES_NO_SETBUF
828             Normally <STRONG>ncurses</STRONG> enables buffered output during  ter-
829             minal  initialization.   This  is  done  (as  in SVr4
830             curses) for performance reasons.   For  testing  pur-
831             poses, both of <STRONG>ncurses</STRONG> and certain applications, this
832             feature    is    made    optional.     Setting    the
833             NCURSES_NO_SETBUF variable disables output buffering,
834             leaving the output  in  the  original  (usually  line
835             buffered) mode.
836
837        NCURSES_NO_UTF8_ACS
838             During initialization, the <STRONG>ncurses</STRONG> library checks for
839             special cases where VT100 line-drawing (and the  cor-
840             responding   alternate  character  set  capabilities)
841             described in the terminfo are known  to  be  missing.
842             Specifically,  when  running  in  a UTF-8 locale, the
843             Linux console emulator and  the  GNU  screen  program
844             ignore  these.   Ncurses  checks the TERM environment
845             variable for these.  For  other  special  cases,  you
846             should  set  this  environment  variable.  Doing this
847             tells ncurses to use Unicode values which  correspond
848             to the VT100 line-drawing glyphs.  That works for the
849             special cases cited, and is likely to work for termi-
850             nal emulators.
851
852             When  setting  this  variable, you should set it to a
853             nonzero value.  Setting it to zero (or to  a  nonnum-
854             ber) disables the special check for Linux and screen.
855
856        NCURSES_TRACE
857             During initialization, the <STRONG>ncurses</STRONG> debugging  library
858             checks  the  NCURSES_TRACE symbol.  If it is defined,
859             to a numeric value, <STRONG>ncurses</STRONG> calls the <STRONG>trace</STRONG> function,
860             using that value as the argument.
861
862             The  argument  values, which are defined in <STRONG>curses.h</STRONG>,
863             provide several types of information.   When  running
864             with  traces enabled, your application will write the
865             file <STRONG>trace</STRONG> to the current directory.
866
867        TERM Denotes your terminal type.  Each  terminal  type  is
868             distinct, though many are similar.
869
870        TERMCAP
871             If the <STRONG>ncurses</STRONG> library has been configured with <EM>term-</EM>
872             <EM>cap</EM> support, <STRONG>ncurses</STRONG>  will  check  for  a  terminal's
873             description in termcap form if it is not available in
874             the terminfo database.
875
876             The  TERMCAP  symbol  contains  either   a   terminal
877             description  (with  newlines stripped out), or a file
878             name telling where the  information  denoted  by  the
879             TERM  symbol  exists.   In  either  case,  setting it
880             directs <STRONG>ncurses</STRONG> to ignore the usual  place  for  this
881             information, e.g., /etc/termcap.
882
883        TERMINFO
884             Overrides the directory in which <STRONG>ncurses</STRONG> searches for
885             your terminal description.  This is the simplest, but
886             not  the  only way to change the list of directories.
887             The complete list of directories in order follows:
888
889             -  the last directory to which <STRONG>ncurses</STRONG> wrote, if any,
890                is searched first
891
892             -  the directory specified by the TERMINFO symbol
893
894             -  $HOME/.terminfo
895
896             -  directories listed in the TERMINFO_DIRS symbol
897
898             -  one or more directories whose names are configured
899                and  compiled  into  the  ncurses  library,  e.g.,
900                /usr/share/terminfo
901
902        TERMINFO_DIRS
903             Specifies  a list of directories to search for termi-
904             nal descriptions.  The list is  separated  by  colons
905             (i.e.,  ":") on Unix, semicolons on OS/2 EMX.  All of
906             the terminal descriptions are in terminfo form, which
907             makes  a  subdirectory  named for the first letter of
908             the terminal names therein.
909
910        TERMPATH
911             If TERMCAP does not hold a  file  name  then  <STRONG>ncurses</STRONG>
912             checks  the  TERMPATH  symbol.   This  is  a  list of
913             filenames separated by spaces or colons  (i.e.,  ":")
914             on  Unix,  semicolons  on  OS/2 EMX.  If the TERMPATH
915             symbol  is  not  set,  <STRONG>ncurses</STRONG>  looks  in  the  files
916             /etc/termcap,       /usr/share/misc/termcap       and
917             $HOME/.termcap, in that order.
918
919        The library may be configured to disregard  the  following
920        variables  when  the current user is the superuser (root),
921        or if the application uses setuid or  setgid  permissions:
922        $TERMINFO, $TERMINFO_DIRS, $TERMPATH, as well as $HOME.
923
924
925 </PRE>
926 <H2>ALTERNATE CONFIGURATIONS</H2><PRE>
927        Several  different  configurations are possible, depending
928        on  the  configure  script  options  used  when   building
929        <STRONG>ncurses</STRONG>.   There  are a few main options whose effects are
930        visible to the applications developer using <STRONG>ncurses</STRONG>:
931
932        --disable-overwrite
933             The standard include for <STRONG>ncurses</STRONG> is as noted in  <STRONG>SYN-</STRONG>
934             <STRONG>OPSIS</STRONG>:
935
936             <STRONG>#include</STRONG> <STRONG>&lt;curses.h&gt;</STRONG>
937
938             This  option is used to avoid filename conflicts when
939             <STRONG>ncurses</STRONG> is not the main implementation of  curses  of
940             the  computer.   If  <STRONG>ncurses</STRONG>  is  installed disabling
941             overwrite, it puts its  headers  in  a  subdirectory,
942             e.g.,
943
944             <STRONG>#include</STRONG> <STRONG>&lt;ncurses/curses.h&gt;</STRONG>
945
946             It  also  omits a symbolic link which would allow you
947             to use <STRONG>-lcurses</STRONG> to build executables.
948
949        --enable-widec
950             The configure script renames the library and (if  the
951             <STRONG>--disable-overwrite</STRONG>  option  is used) puts the header
952             files  in  a  different  subdirectory.   All  of  the
953             library  names  have  a  "w"  appended to them, i.e.,
954             instead of
955
956             <STRONG>-lncurses</STRONG>
957
958             you link with
959
960             <STRONG>-lncursesw</STRONG>
961
962             You must also define <STRONG>_XOPEN_SOURCE_EXTENDED</STRONG> when com-
963             piling  for  the  wide-character  library  to use the
964             extended (wide-character)  functions.   The  <STRONG>curses.h</STRONG>
965             file   which  is  installed  for  the  wide-character
966             library is designed to be compatible with the  normal
967             library's header.  Only the size of the <STRONG>WINDOW</STRONG> struc-
968             ture differs, and very few applications require  more
969             than  a  pointer  to  <STRONG>WINDOW</STRONG>s.   If  the  headers are
970             installed  allowing  overwrite,  the   wide-character
971             library's  headers should be installed last, to allow
972             applications to be built using  either  library  from
973             the same set of headers.
974
975        --with-shared
976
977        --with-normal
978
979        --with-debug
980
981        --with-profile
982             The  shared  and normal (static) library names differ
983             by   their   suffixes,   e.g.,   <STRONG>libncurses.so</STRONG>    and
984             <STRONG>libncurses.a</STRONG>.   The debug and profiling libraries add
985             a "_g" and a "_p" to  the  root  names  respectively,
986             e.g., <STRONG>libncurses_g.a</STRONG> and <STRONG>libncurses_p.a</STRONG>.
987
988        --with-trace
989             The  <STRONG>trace</STRONG>  function  normally  resides  in the debug
990             library, but it is sometimes useful to configure this
991             in  the  shared  library.   Configure  scripts should
992             check for the function's existence rather than assum-
993             ing it is always in the debug library.
994
995
996 </PRE>
997 <H2>FILES</H2><PRE>
998        /usr/share/tabset
999             directory  containing  initialization  files  for the
1000             terminal capability database /usr/share/terminfo ter-
1001             minal capability database
1002
1003
1004 </PRE>
1005 <H2>SEE ALSO</H2><PRE>
1006        <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>  and  related  pages whose names begin "curs_"
1007        for detailed routine descriptions.
1008
1009
1010 </PRE>
1011 <H2>EXTENSIONS</H2><PRE>
1012        The  <STRONG>ncurses</STRONG>  library  can  be  compiled  with  an  option
1013        (<STRONG>-DUSE_GETCAP</STRONG>) that falls back to the old-style /etc/term-
1014        cap file if the terminal setup code cannot find a terminfo
1015        entry  corresponding  to <STRONG>TERM</STRONG>.  Use of this feature is not
1016        recommended, as it essentially includes an entire  termcap
1017        compiler  in the <STRONG>ncurses</STRONG> startup code, at significant cost
1018        in core and startup cycles.
1019
1020        The <STRONG>ncurses</STRONG>  library  includes  facilities  for  capturing
1021        mouse  events  on certain terminals (including xterm). See
1022        the <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG> manual page for details.
1023
1024        The <STRONG>ncurses</STRONG> library includes facilities for responding  to
1025        window  resizing  events,  e.g., when running in an xterm.
1026        See the <STRONG><A HREF="resizeterm.3x.html">resizeterm(3x)</A></STRONG> and <STRONG><A HREF="wresize.3x.html">wresize(3x)</A></STRONG>  manual  pages  for
1027        details.   In addition, the library may be configured with
1028        a SIGWINCH handler.
1029
1030        The <STRONG>ncurses</STRONG> library extends the fixed set of function  key
1031        capabilities  of  terminals  by  allowing  the application
1032        designer to define additional key  sequences  at  runtime.
1033        See the <STRONG><A HREF="define_key.3x.html">define_key(3x)</A></STRONG> <STRONG><A HREF="key_defined.3x.html">key_defined(3x)</A></STRONG>, and <STRONG><A HREF="keyok.3x.html">keyok(3x)</A></STRONG> man-
1034        ual pages for details.
1035
1036        The <STRONG>ncurses</STRONG> library can exploit the capabilities of termi-
1037        nals  which  implement the ISO-6429 SGR 39 and SGR 49 con-
1038        trols, which allow an application to reset the terminal to
1039        its  original  foreground and background colors.  From the
1040        users' perspective, the application is able to  draw  col-
1041        ored  text  on  a  background  whose color is set indepen-
1042        dently, providing better  control  over  color  contrasts.
1043        See the <STRONG><A HREF="default_colors.3x.html">default_colors(3x)</A></STRONG> manual page for details.
1044
1045        The  <STRONG>ncurses</STRONG>  library  includes  a  function for directing
1046        application output to a printer attached to  the  terminal
1047        device.  See the <STRONG><A HREF="curs_print.3x.html">curs_print(3x)</A></STRONG> manual page for details.
1048
1049
1050 </PRE>
1051 <H2>PORTABILITY</H2><PRE>
1052        The  <STRONG>ncurses</STRONG>  library is intended to be BASE-level confor-
1053        mant with the  XSI  Curses  standard.   The  EXTENDED  XSI
1054        Curses  functionality  (including  color  support) is sup-
1055        ported.
1056
1057        A small number of local differences (that  is,  individual
1058        differences  between the XSI Curses and <STRONG>ncurses</STRONG> calls) are
1059        described in  <STRONG>PORTABILITY</STRONG>  sections  of  the  library  man
1060        pages.
1061
1062        The routine <STRONG>has_key</STRONG> is not part of XPG4, nor is it present
1063        in SVr4.  See the <STRONG><A HREF="curs_getch.3x.html">curs_getch(3x)</A></STRONG> manual page for  details.
1064
1065        The  routine  <STRONG>slk_attr</STRONG>  is  not  part  of  XPG4, nor is it
1066        present in SVr4.  See the  <STRONG><A HREF="curs_slk.3x.html">curs_slk(3x)</A></STRONG>  manual  page  for
1067        details.
1068
1069        The  routines <STRONG>getmouse</STRONG>, <STRONG>mousemask</STRONG>, <STRONG>ungetmouse</STRONG>, <STRONG>mouseinter-</STRONG>
1070        <STRONG>val</STRONG>, and <STRONG>wenclose</STRONG> relating to mouse  interfacing  are  not
1071        part  of  XPG4,  nor  are  they  present in SVr4.  See the
1072        <STRONG><A HREF="curs_mouse.3x.html">curs_mouse(3x)</A></STRONG> manual page for details.
1073
1074        The routine <STRONG>mcprint</STRONG> was not present in any previous curses
1075        implementation.   See  the  <STRONG><A HREF="curs_print.3x.html">curs_print(3x)</A></STRONG> manual page for
1076        details.
1077
1078        The routine <STRONG>wresize</STRONG> is not part of XPG4, nor is it present
1079        in SVr4.  See the <STRONG><A HREF="wresize.3x.html">wresize(3x)</A></STRONG> manual page for details.
1080
1081        In  historic curses versions, delays embedded in the capa-
1082        bilities <STRONG>cr</STRONG>, <STRONG>ind</STRONG>, <STRONG>cub1</STRONG>, <STRONG>ff</STRONG> and <STRONG>tab</STRONG> activated corresponding
1083        delay  bits  in  the UNIX tty driver.  In this implementa-
1084        tion, all padding is done by NUL sends.   This  method  is
1085        slightly  more expensive, but narrows the interface to the
1086        UNIX kernel  significantly  and  increases  the  package's
1087        portability correspondingly.
1088
1089
1090 </PRE>
1091 <H2>NOTES</H2><PRE>
1092        The  header  file  <STRONG>&lt;curses.h&gt;</STRONG>  automatically  includes the
1093        header files <STRONG>&lt;stdio.h&gt;</STRONG> and <STRONG>&lt;unctrl.h&gt;</STRONG>.
1094
1095        If standard output from a <STRONG>ncurses</STRONG> program  is  re-directed
1096        to  something  which  is not a tty, screen updates will be
1097        directed to standard error.  This was an undocumented fea-
1098        ture of AT&amp;T System V Release 3 curses.
1099
1100
1101 </PRE>
1102 <H2>AUTHORS</H2><PRE>
1103        Zeyd  M.  Ben-Halim,  Eric  S.  Raymond, Thomas E. Dickey.
1104        Based on pcurses by Pavel Curtis.
1105
1106
1107
1108                                                             <STRONG><A HREF="ncurses.3x.html">ncurses(3x)</A></STRONG>
1109 </PRE>
1110 <HR>
1111 <ADDRESS>
1112 Man(1) output converted with
1113 <a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
1114 </ADDRESS>
1115 </BODY>
1116 </HTML>