mirror of
https://github.com/Aigor44/ncursesw-morphos.git
synced 2024-12-21 07:39:06 +08:00
636 lines
23 KiB
Plaintext
636 lines
23 KiB
Plaintext
'\" t
|
|
.\" $Id: ncurses.3x,v 1.23 1998/02/15 02:05:44 tom Exp $
|
|
.TH ncurses 3X ""
|
|
.ds n 5
|
|
.ds d @DATADIR@/terminfo
|
|
.SH NAME
|
|
\fBncurses\fR - CRT screen handling and optimization package
|
|
.SH SYNOPSIS
|
|
\fB#include <curses.h>\fR
|
|
.br
|
|
.SH DESCRIPTION
|
|
The \fBcurses\fR library routines give the user a terminal-independent method
|
|
of updating character screens with reasonable optimization. This
|
|
implementation is ``new curses'' (ncurses) and is the approved replacement for
|
|
4.4BSD classic curses, which has been discontinued.
|
|
|
|
The \fBncurses\fR routines emulate the \fBcurses\fR(3X) library of System V
|
|
Release 4 UNIX, and the XPG4 curses standard (XSI curses) but the \fBncurses\fR
|
|
library is freely redistributable in source form. Differences from the SVr4
|
|
curses are summarized under the EXTENSIONS and BUGS sections below and
|
|
described in detail in the EXTENSIONS and BUGS sections of individual man
|
|
pages.
|
|
|
|
A program using these routines must be linked with the \fB-lncurses\fR option,
|
|
or (if it has been generated) with the debugging library \fB-lncurses_g\fR.
|
|
(Your system integrator may also have installed these libraries under
|
|
the names \fB-lcurses\fR and \fB-lcurses_g\fR.)
|
|
The ncurses_g library generates trace logs (in a file called 'trace' in the
|
|
current directory) that describe curses actions.
|
|
|
|
The \fBncurses\fR package supports: overall screen, window and pad
|
|
manipulation; output to windows and pads; reading terminal input; control over
|
|
terminal and \fBcurses\fR input and output options; environment query
|
|
routines; color manipulation; use of soft label keys; terminfo capabilities;
|
|
and access to low-level terminal-manipulation routines.
|
|
|
|
To initialize the routines, the routine \fBinitscr\fR or \fBnewterm\fR
|
|
must be called before any of the other routines that deal with windows
|
|
and screens are used. The routine \fBendwin\fR must be called before
|
|
exiting. To get character-at-a-time input without echoing (most
|
|
interactive, screen oriented programs want this), the following
|
|
sequence should be used:
|
|
|
|
\fBinitscr(); cbreak(); noecho();\fR
|
|
|
|
Most programs would additionally use the sequence:
|
|
|
|
\fBnonl();\fR
|
|
\fBintrflush(stdscr, FALSE);\fR
|
|
\fBkeypad(stdscr, TRUE);\fR
|
|
|
|
Before a \fBcurses\fR program is run, the tab stops of the terminal
|
|
should be set and its initialization strings, if defined, must be
|
|
output. This can be done by executing the \fBtput init\fR command
|
|
after the shell environment variable \fBTERM\fR has been exported.
|
|
\fBtset(1)\fR is usually responsible for doing this.
|
|
[See \fBterminfo\fR(\*n) for further details.]
|
|
|
|
The \fBcurses\fR library permits manipulation of data structures,
|
|
called \fIwindows\fR, which can be thought of as two-dimensional
|
|
arrays of characters representing all or part of a CRT screen. A
|
|
default window called \fBstdscr\fR, which is the size of the terminal
|
|
screen, is supplied. Others may be created with \fBnewwin\fR.
|
|
|
|
Note that \fBcurses\fR does not handle overlapping windows, that's done by
|
|
the \fBpanel\fR(3X) library. This means that you can either use
|
|
\fBstdscr\fR or divide the screen into tiled windows and not using
|
|
\fBstdscr\fR at all. Mixing the two will result in unpredictable, and
|
|
undesired, effects.
|
|
|
|
Windows are referred to by variables declared as \fBWINDOW *\fR.
|
|
These data structures are manipulated with routines described here and
|
|
elsewhere in the \fBncurses\fR manual pages. Among which the most basic
|
|
routines are \fBmove\fR and \fBaddch\fR. More general versions of
|
|
these routines are included with names beginning with \fBw\fR,
|
|
allowing the user to specify a window. The routines not beginning
|
|
with \fBw\fR affect \fBstdscr\fR.)
|
|
|
|
After using routines to manipulate a window, \fBrefresh\fR is called,
|
|
telling \fBcurses\fR to make the user's CRT screen look like
|
|
\fBstdscr\fR. The characters in a window are actually of type
|
|
\fBchtype\fR, (character and attribute data) so that other information
|
|
about the character may also be stored with each character.
|
|
|
|
Special windows called \fIpads\fR may also be manipulated. These are windows
|
|
which are not constrained to the size of the screen and whose contents need not
|
|
be completely displayed. See \fBcurs_pad\fR(3X) for more information.
|
|
|
|
In addition to drawing characters on the screen, video attributes and colors
|
|
may be supported, causing the characters to show up in such modes as
|
|
underlined, in reverse video, or in color on terminals that support such
|
|
display enhancements. Line drawing characters may be specified to be output.
|
|
On input, \fBcurses\fR is also able to translate arrow and function keys that
|
|
transmit escape sequences into single values. The video attributes, line
|
|
drawing characters, and input values use names, defined in \fB<curses.h>\fR,
|
|
such as \fBA_REVERSE\fR, \fBACS_HLINE\fR, and \fBKEY_LEFT\fR.
|
|
|
|
If the environment variables \fBLINES\fR and \fBCOLUMNS\fR are set, or if the
|
|
program is executing in a window environment, line and column information in
|
|
the environment will override information read by \fIterminfo\fR. This would
|
|
effect a program running in an AT&T 630 layer, for example, where the size of a
|
|
screen is changeable.
|
|
|
|
If the environment variable \fBTERMINFO\fR is defined, any program using
|
|
\fBcurses\fR checks for a local terminal definition before checking in the
|
|
standard place. For example, if \fBTERM\fR is set to \fBatt4424\fR, then the
|
|
compiled terminal definition is found in
|
|
|
|
\fB\*d/a/att4424\fR.
|
|
|
|
(The \fBa\fR is copied from the first letter of \fBatt4424\fR to avoid
|
|
creation of huge directories.) However, if \fBTERMINFO\fR is set to
|
|
\fB$HOME/myterms\fR, \fBcurses\fR first checks
|
|
|
|
\fB$HOME/myterms/a/att4424\fR,
|
|
|
|
and if that fails, it then checks
|
|
|
|
\fB\*d/a/att4424\fR.
|
|
|
|
This is useful for developing experimental definitions or when write
|
|
permission in \fB\*d\fR is not available.
|
|
|
|
The integer variables \fBLINES\fR and \fBCOLS\fR are defined in
|
|
\fB<curses.h>\fR and will be filled in by \fBinitscr\fR with the size of the
|
|
screen. The constants \fBTRUE\fR and \fBFALSE\fR have the values \fB1\fR and
|
|
\fB0\fR, respectively.
|
|
|
|
The \fBcurses\fR routines also define the \fBWINDOW *\fR variable \fBcurscr\fR
|
|
which is used for certain low-level operations like clearing and redrawing a
|
|
screen containing garbage. The \fBcurscr\fR can be used in only a few
|
|
routines.
|
|
|
|
.SS Routine and Argument Names
|
|
Many \fBcurses\fR routines have two or more versions. The routines prefixed
|
|
with \fBw\fR require a window argument. The routines prefixed with \fBp\fR
|
|
require a pad argument. Those without a prefix generally use \fBstdscr\fR.
|
|
|
|
The routines prefixed with \fBmv\fR require a \fIy\fR and \fIx\fR
|
|
coordinate to move to before performing the appropriate action. The
|
|
\fBmv\fR routines imply a call to \fBmove\fR before the call to the
|
|
other routine. The coordinate \fIy\fR always refers to the row (of
|
|
the window), and \fIx\fR always refers to the column. The upper
|
|
left-hand corner is always (0,0), not (1,1).
|
|
|
|
The routines prefixed with \fBmvw\fR take both a window argument and
|
|
\fIx\fR and \fIy\fR coordinates. The window argument is always
|
|
specified before the coordinates.
|
|
|
|
In each case, \fIwin\fR is the window affected, and \fIpad\fR is the
|
|
pad affected; \fIwin\fR and \fIpad\fR are always pointers to type
|
|
\fBWINDOW\fR.
|
|
|
|
Option setting routines require a Boolean flag \fIbf\fR with the value
|
|
\fBTRUE\fR or \fBFALSE\fR; \fIbf\fR is always of type \fBbool\fR. The
|
|
variables \fIch\fR and \fIattrs\fR below are always of type
|
|
\fBchtype\fR. The types \fBWINDOW\fR, \fBSCREEN\fR, \fBbool\fR, and
|
|
\fBchtype\fR are defined in \fB<curses.h>\fR. The type \fBTERMINAL\fR
|
|
is defined in \fB<term.h>\fR. All other arguments are integers.
|
|
|
|
.SS Routine Name Index
|
|
The following table lists each \fBcurses\fR routine and the name of
|
|
the manual page on which it is described. Routines flagged with `*'
|
|
are ncurses-specific, not described by XPG4 or present in SVr4.
|
|
|
|
.TS
|
|
center tab(/);
|
|
l l
|
|
l l .
|
|
\fBcurses\fR Routine Name/Manual Page Name
|
|
=
|
|
addch/\fBcurs_addch\fR(3X)
|
|
addchnstr/\fBcurs_addchstr\fR(3X)
|
|
addchstr/\fBcurs_addchstr\fR(3X)
|
|
addnstr/\fBcurs_addstr\fR(3X)
|
|
addstr/\fBcurs_addstr\fR(3X)
|
|
attroff/\fBcurs_attr\fR(3X)
|
|
attron/\fBcurs_attr\fR(3X)
|
|
attrset/\fBcurs_attr\fR(3X)
|
|
baudrate/\fBcurs_termattrs\fR(3X)
|
|
beep/\fBcurs_beep\fR(3X)
|
|
bkgd/\fBcurs_bkgd\fR(3X)
|
|
bkgdset/\fBcurs_bkgd\fR(3X)
|
|
border/\fBcurs_border\fR(3X)
|
|
box/\fBcurs_border\fR(3X)
|
|
can_change_color/\fBcurs_color\fR(3X)
|
|
cbreak/\fBcurs_inopts\fR(3X)
|
|
clear/\fBcurs_clear\fR(3X)
|
|
clearok/\fBcurs_outopts\fR(3X)
|
|
clrtobot/\fBcurs_clear\fR(3X)
|
|
clrtoeol/\fBcurs_clear\fR(3X)
|
|
color_content/\fBcurs_color\fR(3X)
|
|
copywin/\fBcurs_overlay\fR(3X)
|
|
curs_set/\fBcurs_kernel\fR(3X)
|
|
def_prog_mode/\fBcurs_kernel\fR(3X)
|
|
def_shell_mode/\fBcurs_kernel\fR(3X)
|
|
define_key/\fBdefine_key\fR(3X)*
|
|
del_curterm/\fBcurs_terminfo\fR(3X)
|
|
delay_output/\fBcurs_util\fR(3X)
|
|
delch/\fBcurs_delch\fR(3X)
|
|
deleteln/\fBcurs_deleteln\fR(3X)
|
|
delscreen/\fBcurs_initscr\fR(3X)
|
|
delwin/\fBcurs_window\fR(3X)
|
|
derwin/\fBcurs_window\fR(3X)
|
|
doupdate/\fBcurs_refresh\fR(3X)
|
|
dupwin/\fBcurs_window\fR(3X)
|
|
echo/\fBcurs_inopts\fR(3X)
|
|
echochar/\fBcurs_addch\fR(3X)
|
|
endwin/\fBcurs_initscr\fR(3X)
|
|
erase/\fBcurs_clear\fR(3X)
|
|
erasechar/\fBcurs_termattrs\fR(3X)
|
|
filter/\fBcurs_util\fR(3X)
|
|
flash/\fBcurs_beep\fR(3X)
|
|
flushinp/\fBcurs_util\fR(3X)
|
|
getbegyx/\fBcurs_getyx\fR(3X)
|
|
getch/\fBcurs_getch\fR(3X)
|
|
getmaxyx/\fBcurs_getyx\fR(3X)
|
|
getmouse/\fBcurs_mouse\fR(3X)*
|
|
getparyx/\fBcurs_getyx\fR(3X)
|
|
getstr/\fBcurs_getstr\fR(3X)
|
|
getsyx/\fBcurs_kernel\fR(3X)
|
|
getwin/\fBcurs_util\fR(3X)
|
|
getyx/\fBcurs_getyx\fR(3X)
|
|
halfdelay/\fBcurs_inopts\fR(3X)
|
|
has_colors/\fBcurs_color\fR(3X)
|
|
has_ic/\fBcurs_termattrs\fR(3X)
|
|
has_il/\fBcurs_termattrs\fR(3X)
|
|
has_key/\fBcurs_getch\fR(3X)*
|
|
hline/\fBcurs_border\fR(3X)
|
|
idcok/\fBcurs_outopts\fR(3X)
|
|
idlok/\fBcurs_outopts\fR(3X)
|
|
immedok/\fBcurs_outopts\fR(3X)
|
|
inch/\fBcurs_inch\fR(3X)
|
|
inchnstr/\fBcurs_inchstr\fR(3X)
|
|
inchstr/\fBcurs_inchstr\fR(3X)
|
|
init_color/\fBcurs_color\fR(3X)
|
|
init_pair/\fBcurs_color\fR(3X)
|
|
initscr/\fBcurs_initscr\fR(3X)
|
|
innstr/\fBcurs_instr\fR(3X)
|
|
insch/\fBcurs_insch\fR(3X)
|
|
insdelln/\fBcurs_deleteln\fR(3X)
|
|
insertln/\fBcurs_deleteln\fR(3X)
|
|
insnstr/\fBcurs_insstr\fR(3X)
|
|
insstr/\fBcurs_insstr\fR(3X)
|
|
instr/\fBcurs_instr\fR(3X)
|
|
intrflush/\fBcurs_inopts\fR(3X)
|
|
is_linetouched/\fBcurs_touch\fR(3X)
|
|
is_wintouched/\fBcurs_touch\fR(3X)
|
|
isendwin/\fBcurs_initscr\fR(3X)
|
|
keyname/\fBcurs_util\fR(3X)
|
|
keyok/\fBkeyok\fR(3X)*
|
|
keypad/\fBcurs_inopts\fR(3X)
|
|
killchar/\fBcurs_termattrs\fR(3X)
|
|
leaveok/\fBcurs_outopts\fR(3X)
|
|
longname/\fBcurs_termattrs\fR(3X)
|
|
mcprint/\fBcurs_print\fR(3X)*
|
|
meta/\fBcurs_inopts\fR(3X)
|
|
mouseinterval/\fBcurs_mouse\fR(3X)*
|
|
mousemask/\fBcurs_mouse\fR(3X)*
|
|
move/\fBcurs_move\fR(3X)
|
|
mvaddch/\fBcurs_addch\fR(3X)
|
|
mvaddchnstr/\fBcurs_addchstr\fR(3X)
|
|
mvaddchstr/\fBcurs_addchstr\fR(3X)
|
|
mvaddnstr/\fBcurs_addstr\fR(3X)
|
|
mvaddstr/\fBcurs_addstr\fR(3X)
|
|
mvcur/\fBcurs_terminfo\fR(3X)
|
|
mvdelch/\fBcurs_delch\fR(3X)
|
|
mvderwin/\fBcurs_window\fR(3X)
|
|
mvgetch/\fBcurs_getch\fR(3X)
|
|
mvgetstr/\fBcurs_getstr\fR(3X)
|
|
mvinch/\fBcurs_inch\fR(3X)
|
|
mvinchnstr/\fBcurs_inchstr\fR(3X)
|
|
mvinchstr/\fBcurs_inchstr\fR(3X)
|
|
mvinnstr/\fBcurs_instr\fR(3X)
|
|
mvinsch/\fBcurs_insch\fR(3X)
|
|
mvinsnstr/\fBcurs_insstr\fR(3X)
|
|
mvinsstr/\fBcurs_insstr\fR(3X)
|
|
mvinstr/\fBcurs_instr\fR(3X)
|
|
mvprintw/\fBcurs_printw\fR(3X)
|
|
mvscanw/\fBcurs_scanw\fR(3X)
|
|
mvwaddch/\fBcurs_addch\fR(3X)
|
|
mvwaddchnstr/\fBcurs_addchstr\fR(3X)
|
|
mvwaddchstr/\fBcurs_addchstr\fR(3X)
|
|
mvwaddnstr/\fBcurs_addstr\fR(3X)
|
|
mvwaddstr/\fBcurs_addstr\fR(3X)
|
|
mvwdelch/\fBcurs_delch\fR(3X)
|
|
mvwgetch/\fBcurs_getch\fR(3X)
|
|
mvwgetstr/\fBcurs_getstr\fR(3X)
|
|
mvwin/\fBcurs_window\fR(3X)
|
|
mvwinch/\fBcurs_inch\fR(3X)
|
|
mvwinchnstr/\fBcurs_inchstr\fR(3X)
|
|
mvwinchstr/\fBcurs_inchstr\fR(3X)
|
|
mvwinnstr/\fBcurs_instr\fR(3X)
|
|
mvwinsch/\fBcurs_insch\fR(3X)
|
|
mvwinsnstr/\fBcurs_insstr\fR(3X)
|
|
mvwinsstr/\fBcurs_insstr\fR(3X)
|
|
mvwinstr/\fBcurs_instr\fR(3X)
|
|
mvwprintw/\fBcurs_printw\fR(3X)
|
|
mvwscanw/\fBcurs_scanw\fR(3X)
|
|
napms/\fBcurs_kernel\fR(3X)
|
|
newpad/\fBcurs_pad\fR(3X)
|
|
newterm/\fBcurs_initscr\fR(3X)
|
|
newwin/\fBcurs_window\fR(3X)
|
|
nl/\fBcurs_outopts\fR(3X)
|
|
nocbreak/\fBcurs_inopts\fR(3X)
|
|
nodelay/\fBcurs_inopts\fR(3X)
|
|
noecho/\fBcurs_inopts\fR(3X)
|
|
nonl/\fBcurs_outopts\fR(3X)
|
|
noqiflush/\fBcurs_inopts\fR(3X)
|
|
noraw/\fBcurs_inopts\fR(3X)
|
|
notimeout/\fBcurs_inopts\fR(3X)
|
|
overlay/\fBcurs_overlay\fR(3X)
|
|
overwrite/\fBcurs_overlay\fR(3X)
|
|
pair_content/\fBcurs_color\fR(3X)
|
|
pechochar/\fBcurs_pad\fR(3X)
|
|
pnoutrefresh/\fBcurs_pad\fR(3X)
|
|
prefresh/\fBcurs_pad\fR(3X)
|
|
printw/\fBcurs_printw\fR(3X)
|
|
putp/\fBcurs_terminfo\fR(3X)
|
|
putwin/\fBcurs_util\fR(3X)
|
|
qiflush/\fBcurs_inopts\fR(3X)
|
|
raw/\fBcurs_inopts\fR(3X)
|
|
redrawwin/\fBcurs_refresh\fR(3X)
|
|
refresh/\fBcurs_refresh\fR(3X)
|
|
reset_prog_mode/\fBcurs_kernel\fR(3X)
|
|
reset_shell_mode/\fBcurs_kernel\fR(3X)
|
|
resetty/\fBcurs_kernel\fR(3X)
|
|
resizeterm/\fBresizeterm\fR(3X)*
|
|
restartterm/\fBcurs_terminfo\fR(3X)
|
|
ripoffline/\fBcurs_kernel\fR(3X)
|
|
savetty/\fBcurs_kernel\fR(3X)
|
|
scanw/\fBcurs_scanw\fR(3X)
|
|
scr_dump/\fBcurs_scr_dump\fR(3X)
|
|
scr_init/\fBcurs_scr_dump\fR(3X)
|
|
scr_restore/\fBcurs_scr_dump\fR(3X)
|
|
scr_set/\fBcurs_scr_dump\fR(3X)
|
|
scrl/\fBcurs_scroll\fR(3X)
|
|
scroll/\fBcurs_scroll\fR(3X)
|
|
scrollok/\fBcurs_outopts\fR(3X)
|
|
set_curterm/\fBcurs_terminfo\fR(3X)
|
|
set_term/\fBcurs_initscr\fR(3X)
|
|
setscrreg/\fBcurs_outopts\fR(3X)
|
|
setsyx/\fBcurs_kernel\fR(3X)
|
|
setterm/\fBcurs_terminfo\fR(3X)
|
|
setupterm/\fBcurs_terminfo\fR(3X)
|
|
slk_attr/\fBcurs_slk\fR(3X)*
|
|
slk_attroff/\fBcurs_slk\fR(3X)
|
|
slk_attron/\fBcurs_slk\fR(3X)
|
|
slk_attrset/\fBcurs_slk\fR(3X)
|
|
slk_clear/\fBcurs_slk\fR(3X)
|
|
slk_init/\fBcurs_slk\fR(3X)
|
|
slk_label/\fBcurs_slk\fR(3X)
|
|
slk_noutrefresh/\fBcurs_slk\fR(3X)
|
|
slk_refresh/\fBcurs_slk\fR(3X)
|
|
slk_restore/\fBcurs_slk\fR(3X)
|
|
slk_set/\fBcurs_slk\fR(3X)
|
|
slk_touch/\fBcurs_slk\fR(3X)
|
|
standend/\fBcurs_attr\fR(3X)
|
|
standout/\fBcurs_attr\fR(3X)
|
|
start_color/\fBcurs_color\fR(3X)
|
|
subpad/\fBcurs_pad\fR(3X)
|
|
subwin/\fBcurs_window\fR(3X)
|
|
syncok/\fBcurs_window\fR(3X)
|
|
termattrs/\fBcurs_termattrs\fR(3X)
|
|
termname/\fBcurs_termattrs\fR(3X)
|
|
tgetent/\fBcurs_termcap\fR(3X)
|
|
tgetflag/\fBcurs_termcap\fR(3X)
|
|
tgetnum/\fBcurs_termcap\fR(3X)
|
|
tgetstr/\fBcurs_termcap\fR(3X)
|
|
tgoto/\fBcurs_termcap\fR(3X)
|
|
tigetflag/\fBcurs_terminfo\fR(3X)
|
|
tigetnum/\fBcurs_terminfo\fR(3X)
|
|
tigetstr/\fBcurs_terminfo\fR(3X)
|
|
timeout/\fBcurs_inopts\fR(3X)
|
|
touchline/\fBcurs_touch\fR(3X)
|
|
touchwin/\fBcurs_touch\fR(3X)
|
|
tparm/\fBcurs_terminfo\fR(3X)
|
|
tputs/\fBcurs_termcap\fR(3X)
|
|
tputs/\fBcurs_terminfo\fR(3X)
|
|
typeahead/\fBcurs_inopts\fR(3X)
|
|
unctrl/\fBcurs_util\fR(3X)
|
|
ungetch/\fBcurs_getch\fR(3X)
|
|
ungetmouse/\fBcurs_mouse\fR(3X)*
|
|
untouchwin/\fBcurs_touch\fR(3X)
|
|
use_default_colors/\fBdft_fgbg\fR(3X)*
|
|
use_env/\fBcurs_util\fR(3X)
|
|
vidattr/\fBcurs_terminfo\fR(3X)
|
|
vidputs/\fBcurs_terminfo\fR(3X)
|
|
vline/\fBcurs_border\fR(3X)
|
|
vwprintw/\fBcurs_printw\fR(3X)
|
|
vwscanw/\fBcurs_scanw\fR(3X)
|
|
waddch/\fBcurs_addch\fR(3X)
|
|
waddchnstr/\fBcurs_addchstr\fR(3X)
|
|
waddchstr/\fBcurs_addchstr\fR(3X)
|
|
waddnstr/\fBcurs_addstr\fR(3X)
|
|
waddstr/\fBcurs_addstr\fR(3X)
|
|
wattroff/\fBcurs_attr\fR(3X)
|
|
wattron/\fBcurs_attr\fR(3X)
|
|
wattrset/\fBcurs_attr\fR(3X)
|
|
wbkgd/\fBcurs_bkgd\fR(3X)
|
|
wbkgdset/\fBcurs_bkgd\fR(3X)
|
|
wborder/\fBcurs_border\fR(3X)
|
|
wclear/\fBcurs_clear\fR(3X)
|
|
wclrtobot/\fBcurs_clear\fR(3X)
|
|
wclrtoeol/\fBcurs_clear\fR(3X)
|
|
wcursyncup/\fBcurs_window\fR(3X)
|
|
wdelch/\fBcurs_delch\fR(3X)
|
|
wdeleteln/\fBcurs_deleteln\fR(3X)
|
|
wechochar/\fBcurs_addch\fR(3X)
|
|
wenclose/\fBcurs_mouse\fR(3X)*
|
|
werase/\fBcurs_clear\fR(3X)
|
|
wgetch/\fBcurs_getch\fR(3X)
|
|
wgetnstr/\fBcurs_getstr\fR(3X)
|
|
wgetstr/\fBcurs_getstr\fR(3X)
|
|
whline/\fBcurs_border\fR(3X)
|
|
winch/\fBcurs_inch\fR(3X)
|
|
winchnstr/\fBcurs_inchstr\fR(3X)
|
|
winchstr/\fBcurs_inchstr\fR(3X)
|
|
winnstr/\fBcurs_instr\fR(3X)
|
|
winsch/\fBcurs_insch\fR(3X)
|
|
winsdelln/\fBcurs_deleteln\fR(3X)
|
|
winsertln/\fBcurs_deleteln\fR(3X)
|
|
winsnstr/\fBcurs_insstr\fR(3X)
|
|
winsstr/\fBcurs_insstr\fR(3X)
|
|
winstr/\fBcurs_instr\fR(3X)
|
|
wmove/\fBcurs_move\fR(3X)
|
|
wnoutrefresh/\fBcurs_refresh\fR(3X)
|
|
wprintw/\fBcurs_printw\fR(3X)
|
|
wredrawln/\fBcurs_refresh\fR(3X)
|
|
wrefresh/\fBcurs_refresh\fR(3X)
|
|
wresize/\fBwresize\fR(3X)*
|
|
wscanw/\fBcurs_scanw\fR(3X)
|
|
wscrl/\fBcurs_scroll\fR(3X)
|
|
wsetscrreg/\fBcurs_outopts\fR(3X)
|
|
wstandend/\fBcurs_attr\fR(3X)
|
|
wstandout/\fBcurs_attr\fR(3X)
|
|
wsyncdown/\fBcurs_window\fR(3X)
|
|
wsyncup/\fBcurs_window\fR(3X)
|
|
wtimeout/\fBcurs_inopts\fR(3X)
|
|
wtouchln/\fBcurs_touch\fR(3X)
|
|
wvline/\fBcurs_border\fR(3X)
|
|
.TE
|
|
.SH RETURN VALUE
|
|
Routines that return an integer return \fBERR\fR upon failure and an
|
|
integer value other than \fBERR\fR upon successful completion, unless
|
|
otherwise noted in the routine descriptions.
|
|
|
|
All macros return the value of the \fBw\fR version, except \fBsetscrreg\fR,
|
|
\fBwsetscrreg\fR, \fBgetyx\fR, \fBgetbegyx\fR, \fBgetmaxyx\fR. The return
|
|
values of \fBsetscrreg\fR, \fBwsetscrreg\fR, \fBgetyx\fR, \fBgetbegyx\fR, and
|
|
\fBgetmaxyx\fR are undefined (\fIi\fR.\fIe\fR., these should not be used as the
|
|
right-hand side of assignment statements).
|
|
|
|
Routines that return pointers return \fBNULL\fR on error.
|
|
.SH SEE ALSO
|
|
\fBterminfo\fR(\*n) and 3X pages whose names begin "curs_" for detailed routine
|
|
descriptions.
|
|
.SH EXTENSIONS
|
|
The \fBcurses\fR library can be compiled with an option (\fB-DTERMCAP_FILE\fR)
|
|
that falls back to the old-style /etc/termcap file if the terminal setup code
|
|
cannot find a terminfo entry corresponding to \fBTERM\fR. Use of this feature
|
|
is not recommended, as it essentially includes an entire termcap compiler in
|
|
the \fBcurses\fR startup code, at significant cost in core and startup cycles.
|
|
|
|
Compiling with \fB-DTERMCAP_FILE\fR changes the library's initialization
|
|
sequence in a way intended to mimic the behavior of 4.4BSD curses. If there is
|
|
no local or system terminfo entry matching \fBTERM\fR, then the library looks
|
|
for termcap entries in the following places: (1) if \fBTERMINFO\fR is
|
|
undefined, in the file named by \fBTERMCAP_FILE\fR; (2) if \fBTERMINFO\fR is
|
|
defined and begins with a slash, it is interpreted as the name of a termcap
|
|
file to search for \fBTERM\fR; (3) otherwise, if \fBTERMINFO\fR has a leading
|
|
string that looks like a terminal entry name list, and it matches \fBTERM\fR,
|
|
the contents of \fBTERMINFO\fR is interpreted as a termcap; (4) if
|
|
\fBTERMINFO\fR looks like a termcap but doesn't match \fBTERM\fR, the termcap
|
|
file is searched for among the colon-separated paths in the environment
|
|
variable \fBTERMPATHS\fR if that is defined, and in ~/.termcap and the file
|
|
value of \fBTERMCAP_FILE\fR otherwise.
|
|
|
|
Versions of \fBcurses\fR compiled on PC clones support display of the PC ROM
|
|
characters (including ROM characters 0-31, which stock SVr4 curses cannot
|
|
display). See the EXTENSIONS sections of \fBcurs_addch\fR(3X) and
|
|
\fBcurs_attr\fR(3X).
|
|
|
|
The \fBcurses\fR library includes facilities for capturing mouse events on
|
|
certain terminals (including xterm). See the \fBcurs_mouse\fR(3X)
|
|
manual page for details.
|
|
|
|
The \fBcurses\fR library includes a function for directing application output
|
|
to a printer attached to the terminal device. See the \fBcurs_print\fR(3X)
|
|
manual page for details.
|
|
.SH PORTABILITY
|
|
The \fBcurses\fR library is intended to be BASE-level conformant with the XSI
|
|
Curses standard. Certain portions of the EXTENDED XSI Curses functionality
|
|
(including color support) are supported. The following EXTENDED XSI Curses
|
|
calls in support of wide (multibyte) characters are not yet implemented:
|
|
\fBaddnwstr\fB,
|
|
\fBaddwstr\fB,
|
|
\fBmvaddnwstr\fB,
|
|
\fBmvwaddnwstr\fB,
|
|
\fBmvaddwstr\fB,
|
|
\fBwaddnwstr\fB,
|
|
\fBwaddwstr\fB,
|
|
\fBadd_wch\fB,
|
|
\fBwadd_wch\fB,
|
|
\fBmvadd_wch\fB,
|
|
\fBmvwadd_wch\fB,
|
|
\fBadd_wchnstr\fB,
|
|
\fBadd_wchstr\fB,
|
|
\fBwadd_wchnstr\fB,
|
|
\fBwadd_wchstr\fB,
|
|
\fBmvadd_wchnstr\fB,
|
|
\fBmvadd_wchstr\fB,
|
|
\fBmvwadd_wchnstr\fB,
|
|
\fBmvwadd_wchstr\fB,
|
|
\fBbkgrndset\fB,
|
|
\fBbkgrnd\fB,
|
|
\fBgetbkgrnd\fB,
|
|
\fBwbkgrnd\fB,
|
|
\fBwbkgrndset\fB,
|
|
\fBwgetbkgrnd\fB,
|
|
\fBborder_set\fB,
|
|
\fBwborder_set\fB,
|
|
\fBbox_set\fB,
|
|
\fBhline_set\fB,
|
|
\fBmvhline_set\fB,
|
|
\fBmvvline_set\fB,
|
|
\fBmvwhline_set\fB,
|
|
\fBmvwvline_set\fB,
|
|
\fBwhline_set\fB,
|
|
\fBvhline_set\fB,
|
|
\fBwvline_set\fB,
|
|
\fBecho_wchar\fB,
|
|
\fBwecho_wchar\fB,
|
|
\fBerasewchar\fB,
|
|
\fBkillwchar\fB,
|
|
\fBget_wch\fB,
|
|
\fBmvget_wch\fB,
|
|
\fBmvwget_ch\fB,
|
|
\fBwget_wch\fB,
|
|
\fBgetwchtype\fB,
|
|
\fBget_wstr\fB,
|
|
\fBgetn_wstr\fB,
|
|
\fBwget_wstr\fB,
|
|
\fBwgetn_wstr\fB,
|
|
\fBmvget_wstr\fB,
|
|
\fBmvgetn_wstr\fB,
|
|
\fBmvwget_wstr\fB,
|
|
\fBmvwgetn_wstr\fB,
|
|
\fBinnwstr\fB,
|
|
\fBinwstr\fB,
|
|
\fBwinnwstr\fB,
|
|
\fBwinwstr\fB,
|
|
\fBmvinnwstr\fB,
|
|
\fBmvinwstr\fB,
|
|
\fBmvwinnwstr\fB,
|
|
\fBmvwinwstr\fB,
|
|
\fBins_nwstr\fB,
|
|
\fBins_wstr\fB,
|
|
\fBmvins_nwstr\fB,
|
|
\fBmvins_wstr\fB,
|
|
\fBmvwins_nwstr\fB,
|
|
\fBmvwins_wstr\fB,
|
|
\fBwins_nwstr\fB,
|
|
\fBwins_wstr\fB,
|
|
\fBins_wch\fB,
|
|
\fBwins_wch\fB,
|
|
\fBmvins_wch\fB,
|
|
\fBmvwins_wch\fB,
|
|
\fBin_wch\fB,
|
|
\fBwin_wch\fB,
|
|
\fBmvin_wch\fB,
|
|
\fBmvwin_wch\fB,
|
|
\fBinwchstr\fB,
|
|
\fBinwchnstr\fB,
|
|
\fBwinwchstr\fB,
|
|
\fBwinwchnstr\fB,
|
|
\fBmvinwchstr\fB,
|
|
\fBmvinwchnstr\fB,
|
|
\fBmvinwchstr\fB,
|
|
\fBmvwinwchnstr\fB.
|
|
.PP
|
|
A small number of local differences (that is, individual differences between
|
|
the XSI Curses and \fBcurses\fR calls) are described in \fBPORTABILITY\fR
|
|
sections of the library man pages.
|
|
.PP
|
|
The routine \fBhas_key\fR is not part of XPG4, nor is it present in SVr4. See
|
|
the \fBcurs_getch\fR(3X) manual page for details.
|
|
.PP
|
|
The routine \fBslk_attr\fR is not part of XPG4, nor is it present in SVr4. See
|
|
the \fBcurs_slk\fR(3X) manual page for details.
|
|
.PP
|
|
The routines \fBgetmouse\fR, \fBmousemask\fR, \fBungetmouse\fR,
|
|
\fBmouseinterval\fR, and \fBwenclose\fR relating to mouse interfacing are not
|
|
part of XPG4, nor are they present in SVr4. See the \fBcurs_mouse\fR(3X)
|
|
manual page for details.
|
|
.PP
|
|
The routine \fBmcprint\fR was not present in any previous curses
|
|
implementation. See the \fBcurs_print\fR(3X) manual page for details.
|
|
.PP
|
|
The routine \fBwresize\fR is not part of XPG4, nor is it present in SVr4. See
|
|
the \fBwresize\fR(3X) manual page for details.
|
|
.PP
|
|
In historic curses versions, delays embedded in the capabilities \fBcr\fR,
|
|
\fBind\fR, \fBcub1\fR, \fBff\fR and \fBtab\fR activated corresponding delay
|
|
bits in the UNIX tty driver. In this implementation, all padding is done by
|
|
NUL sends. This method is slightly more expensive, but narrows the interface
|
|
to the UNIX kernel significantly and increases the package's portability
|
|
correspondingly.
|
|
.PP
|
|
In the XSI standard and SVr4 manual pages, many entry points have prototype
|
|
arguments of the for \fBchar *const\fR (or \fBcchar_t *const\fR, or \fBwchar_t
|
|
*const\fR, or \fBvoid *const\fR). Depending on one's interpretation of the
|
|
ANSI C standard (see section 3.5.4.1), these declarations are either (a)
|
|
meaningless, or (b) meaningless and illegal. The declaration \fBconst char
|
|
*x\fR is a modifiable pointer to unmodifiable data, but \fBchar *const x\fR' is
|
|
an unmodifiable pointer to modifiable data. Given that C passes arguments by
|
|
value, \fB<type> *const\fR as a formal type is at best dubious. Some compilers
|
|
choke on the prototypes. Therefore, in this implementation, they have been
|
|
changed to \fBconst <type> *\fR globally.
|
|
.SH NOTES
|
|
The header file \fB<curses.h>\fR automatically includes the header files
|
|
\fB<stdio.h>\fR and \fB<unctrl.h>\fR.
|
|
|
|
If standard output from a \fBcurses\fR program is re-directed to something
|
|
which is not a tty, screen updates will be directed to standard error. This
|
|
was an undocumented feature of AT&T System V Release 3 curses.
|
|
.SH AUTHORS
|
|
Zeyd M. Ben-Halim, Eric S. Raymond. Descends from the original pcurses
|
|
by Pavel Curtis.
|
|
.\"#
|
|
.\"# The following sets edit modes for GNU EMACS
|
|
.\"# Local Variables:
|
|
.\"# mode:nroff
|
|
.\"# fill-column:79
|
|
.\"# End:
|