INITSCR(3XCURSES)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; other‐
wise, 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(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Standard │
├────────────────────┼─────────────────┤
│MT-Level │ Unsafe │
└────────────────────┴─────────────────┘
SEE ALSOdel_curterm(3XCURSES), delscreen(3XCURSES), doupdate(3XCURSES), end‐
win(3XCURSES), filter(3XCURSES), libcurses(3XCURSES),
slk_attroff(3XCURSES), use_env(3XCURSES), attributes(5), standards(5)
Jun 5, 2002 INITSCR(3XCURSES)