Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ curses(3T) — UTek W2.3

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
     nonl()                        unset newline mapping



Printed 10/17/86                                                1





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



     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), termcap(5t).











Printed 10/17/86                                                2





































































%%index%%
na:72,92;
sy:164,669;
de:833,3147;4124,2708;
ca:6832,280;
se:7112,151;
%%index%%000000000104

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