initscr(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

def_prog_mode(3XCURSES) 				  X/Open Curses Library Functions				   def_prog_mode(3XCURSES)

NAME

       def_prog_mode, def_shell_mode, reset_prog_mode, reset_shell_mode - save/restore terminal modes

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>

       int def_prog_mode(void);

       int def_shell_mode(void);

       int reset_prog_mode(void);

       int reset_shell_mode(void);

DESCRIPTION

       The  def_prog_mode() and def_shell_mode() functions save the current terminal modes as "program" (within X/Open Curses) or "shell" (outside
       X/Open Curses).	The modes are saved automatically by initscr(3XCURSES), newterm(3XCURSES), and setupterm(3XCURSES).

       The reset_prog_mode() and reset_shell_mode() functions  reset the current terminal modes to "program" (within  X/Open  Curses)  or  "shell"
       (outside X/Open Curses). The endwin(3XCURSES) function automatically calls the reset_shell_mode() function and the doupdate(3XCURSES) func-
       tion calls the reset_prog_mode() function after calling endwin().

RETURN VALUES

       On success, these functions return OK. Otherwise, they return ERR.

ERRORS

       None.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       endwin(3XCURSES), initscr(3XCURSES), libcurses(3XCURSES), newterm(3XCURSES), setupterm(3XCURSES), attributes(5), standards(5)

SunOS 5.10							    5 Jun 2002						   def_prog_mode(3XCURSES)

Linux and UNIX Man Pages

initscr(3xcurses) [sunos man page]

Check Out this Related Man Page