Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

getenv(3c)

getenv(3f)

termcap(5t)



CURSES(3T)              COMMAND REFERENCE              CURSES(3T)



NAME
     curses - screen functions with ``optimal'' cursor motion

SYNOPSIS
     #include <curses.h>
     #include <termcap.h>

     cc [ flags ] filenames -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
          crmode()                   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
          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) coordinates
          inch()                     get char at current (y,x) coordinates
          initscr()                  initialize screens
          insch(c)                   insert a char c
          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



Printed 3/13/89                                                 1





CURSES(3T)              COMMAND REFERENCE              CURSES(3T)



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

CAVEATS
     The size of the termcap entry buffer in this system is
     required to be TCAPSIZ (defined in termcap.h).  If this is
     not true, the program may get a memory fault.

SEE ALSO
     getenv(3c), getenv(3f), and termcap(5t).










Printed 3/13/89                                                 2



%%index%%
na:312,108;
sy:420,1033;
de:1453,3671;5508,3164;
ca:8672,344;
se:9016,182;
%%index%%000000000108

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026