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