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>