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



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

SYNOPSIS
     cc [flags] files -lcur5.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)



January 1992                                                    1

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



          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)
          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.



2                                                    January 1992

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



     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.
     wscanw(win,fmt,arg1,arg2,...)
          scanf through win.
     wstandend(win)
          End standout mode on win.



January 1992                                                    3

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



     wstandout(win)
          Start standout mode on win.
SEE ALSO
     ioctl(2), curses(3X), getenv(3), termcap(4), terminfo(4),
     tty(4)


















































4                                                    January 1992