newterm(3xcurses) [sunos man page]
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 termi- nation, 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(5) 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(5), standards(5) SunOS 5.10 5 Jun 2002 initscr(3XCURSES)
Check Out this Related Man Page
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 termi- nation, 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(5) 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(5), standards(5) SunOS 5.10 5 Jun 2002 initscr(3XCURSES)