CURSES(3X)                           BSD                            CURSES(3X)



NAME
     curses - screen functions with "optimal" cursor motion

SYNOPSIS
     cc [ flags ] files -lcurses -ltermcap [ libraries ]

DESCRIPTION
     These routines give the user a method of updating screens with reasonable
     optimization.  They keep an image of the current screen, and 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
     addch(ch)                            add a character to stdscr
     addstr(str)                          add a string to stdscr
     box(win,vert,hor)                    draw a box around a window
     cbreak()                             set cbreak mode
     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
     delch()                              delete a character
     deleteln()                           delete a line
     delwin(win)                          delete win
     echo()                               set echo mode
     endwin()                             end window modes
     erase()                              erase stdscr
     flusok(win,boolf)                    set flush-on-refresh flag for win
     getch()                              get a character through stdscr
     getcap(name)                         get terminal capability name
     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 char
     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
     nocbreak()                           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
     touchline(win,y,sx,ex)               mark line y sx through sy as changed
     touchoverlap(win1,win2)              mark overlap of win1 on win2 as changed
     touchwin(win)                        "change" all of win
     unctrl(ch)                           printable version of ch
     waddch(win,ch)                       add character 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
     wstandout(win)                       start standout mode on win

SEE ALSO
     ioctl(2), getenv(3), tty(4), termcap(5)

AUTHOR
     Ken Arnold