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