curses5.0(3X)                                       curses5.0(3X)



     NAME
          curses5.0 - BSD-style screen functions with  optimal  cursor
          motion

     SYNOPSIS
          cc [flags] files -lcurses5.0 -ltermcap [libraries]

     DESCRIPTION
          These routines are a subset of the routines provided in the
          new curses library and are provided for compatibility with
          programs that use the old curses and termcap libraries.
          These routines give the user a method for updating screens
          with reasonable optimization.  They maintain an image of the
          current screen while the user sets up an image of a new one.
          Then the refresh() tells the routines to make the current
          screen look like the new one.  In order to initialize the
          routines, the routine initscr() must be called before any of
          the other routines that deal with windows and screens are
          used.  The routine endwin() should be called before exiting.

     FUNCTIONS
          Routines marked with a plus (+) are macros.

          addch(ch)+     Add a character to stdscr.
          addstr(str)+   Add a string to stdscr.
          box(win,vert,hor)
                         Draw a box around a window.
          clear()+       Clear stdscr.
          clearok(scr,boolf)+
                         Set clear flag for scr.
          clrtobot()+    Clear to bottom on stdscr.
          clrtoeol()+    Clear to end-of-line on stdscr.
          crmode()       Set cbreak mode.
          delch()+       Delete a character.
          deleteln()+    Delete a line.
          delwin(win)    Delete win.
          echo()         Set echo mode.
          endwin()       End window modes.
          erase()+       Erase stdscr.
          getcap(name)   Get terminal capability name.
          getch()+       Get a character through stdscr.
          getstr(str)+   Get a string through stdscr.
          gettmode()     Get tty modes.
          getyx(win,y,x)+
                         Get (y,x) coordinates.
          inch()+        Get character at current (y,x) coordinates.
          initscr()      Initialize screens.
          insch(c)+      Insert a character.
          insertln()+    Insert a line.
          leaveok(win,boolf)+
                         Set leave flag for win.
          longname(termbuf,name)



     April, 1990                                                     1

     curses5.0(3X)                                       curses5.0(3X)



                         Get long name from termbuf.
          move(y,x)+     Move to (y,x) on stdscr.
          mvcur(lasty,lastx,newy,newx)
                         Actually move cursor.
          newwin(lines,cols,begin_y,begin_x)
                         Create a new window.
          nl()           Set newline mapping.
          nocrmode()     Unset cbreak mode.
          noecho()       Unset echo mode.
          nonl()         Unset newline mapping.
          noraw()        Unset raw mode.
          overlay(win1,win2)
                         Overlay win1 on win2.
          overwrite(win1,win2)
                         Overwrite win1 on top of win2.
          printw(fmt,arg1,arg2,...)
                         printf on stdscr.
          raw()          Set raw mode.
          refresh()+     Make current screen look like stdscr.
          resetty()      Reset tty flags to stored value.
          savetty()      Stored current tty flags.
          scanw(fmt,arg1,arg2,...)
                         scanf through stdscr.
          scroll(win)    Scroll win one line.
          scrollok(win,boolf)+
                         Set scroll flag.
          setterm(name)  Set term variables for name.
          standend()+    End standout mode.
          standout()+    Start standout mode.
          subwin(win,lines,cols,begin_y,begin_x)
                         Create a subwindow.
          touchwin(win)  Change all of win.
          unctrl(ch)     Printable version of ch.
          waddch(win,ch) Add character ch to win.
          waddstr(win,str)
                         Add string to win.
          wclear(win)    Clear win.
          wclrtobot(win) Clear to bottom of win.
          wclrtoeol(win) Clear to end-of-line on win.
          wdelch(win,c)  Delete character from win.
          wdeleteln(win) Delete line from win.
          werase(win)    Erase win.
          wgetch(win)    Get a character through win.
          wgetstr(win,str)
                         Get a string through win.
          winch(win)+    Get character at current (y,x) in win.
          winsch(win,c)  Insert character into win.
          winsertln(win) Insert line into win.
          wmove(win,y,x) Set current (y,x) coordinates on win.
          wprintw(win,fmt,arg1,arg2,...)
                         printf on win.
          wrefresh(win)  Make screen look like win.



     2                                                     April, 1990

     curses5.0(3X)                                       curses5.0(3X)



          wscanw(win,fmt,arg1,arg2,...)
                         scanf through win.
          wstandend(win) End standout mode on win.
          wstandout(win) Start standout mode on win.
     SEE ALSO
          ioctl(2), curses(3X), getenv(3), termcap(4), terminfo(4),
          tty(4).
















































     April, 1990                                                     3