CURSES(3)                      Library Routines                      CURSES(3)

NAME

       curses - screen functions with ``optimal

SYNOPSIS

       occ -flags -L/usr/lib files -llibcurses -llibtermcap

DESCRIPTION

       These  routines give the user a method of updating screens with reason‐
       able 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 rou‐
       tines 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.

SEE ALSO

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

       Screen  Updating and Cursor Movement Optimization: A Library Package by
       Ken Arnold.

AUTHOR

       Ken Arnold

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 stdscr

       echo() set echo mode

       endwin()
              end window modes

       erase()
              erase stdscr

       flusok(win,boolf)
              set flush-on-refresh flag for win

       getch()
              get a char 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) co-ordinates

       inch() get char at current (y,x) co-ordinates

       initscr()
              initialize screens

       insch(c)
              insert a char

       insertln()
              insert a line

       leaveok(win,boolf)
              set leave flag for stdscr

       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 char 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 char from win

       wdeleteln(win)
              delete line from win

       werase(win)
              erase win

       wgetch(win)
              get a char through win

       wgetstr(win,str)
              get a string through win

       winch(win)
              get char at current (y,x) in win

       winsch(win,c)
              insert char into win

       winsertln(win)
              insert line into win

       wmove(win,y,x)
              set current (y,x) co-ordinates 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

HISTORY

       This package first appeared in 4.0BSD.



GNO                             September 1997                       CURSES(3)