INITSCR(3XCURSES) X/Open Curses Library Functions INITSCR(3XCURSES)
NAME
initscr, newterm - screen initialization functions
SYNOPSIS
cc [
flag... ]
file...
-I /usr/xpg4/include
-L /usr/xpg4/lib \
-R /usr/xpg4/lib
-lcurses [
library... ]
c89 [
flag... ]
file...
-lcurses [
library... ]
#include <curses.h>
WINDOW *initscr(
void);
SCREEN *newterm(
char *type,
FILE *outfp,
FILE *infp);
PARAMETERS
type Is a string defining the terminal type to be used in place
of
TERM.
outfp Is a pointer to a file to be used for output to the
terminal.
infp Is the pointer to a file to be used for input to the
terminal.
DESCRIPTION
The
initscr() function initializes X/Open Curses data structures,
determines the terminal type, and ensures the first call to
refresh(3XCURSES) clears the screen.
The
newterm() function opens a new terminal with each call. It
should be used instead of
initscr() when the program interacts with
more than one terminal. It returns a variable of type
SCREEN, which
should be used for later reference to that terminal. Before program
termination,
endwin() should be called for each terminal.
The only functions that you can call before calling
initscr() or
newterm() are
filter(3XCURSES),
ripoffline(3XCURSES),
slk_init(3XCURSES), and
use_env(3XCURSES).
RETURN VALUES
On success, the
initscr() function returns a pointer to
stdscr;
otherwise,
initscr() does not return.
On success, the
newterm() function returns a pointer to the specified
terminal; otherwise, a null pointer is returned.
ERRORS
None.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
SEE ALSO
del_curterm(3XCURSES),
delscreen(3XCURSES),
doupdate(3XCURSES),
endwin(3XCURSES),
filter(3XCURSES),
libcurses(3XCURSES),
slk_attroff(3XCURSES),
use_env(3XCURSES),
attributes(7),
standards(7) June 5, 2002 INITSCR(3XCURSES)
