Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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,  de-
       termines	 the  terminal	type,  and  ensures  the  first	 call  to  re-
       fresh(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 ALSO
       del_curterm(3XCURSES),  delscreen(3XCURSES),  doupdate(3XCURSES),  end-
       win(3XCURSES),	  filter(3XCURSES),    libcurses(3XCURSES),    slk_at-
       troff(3XCURSES),	use_env(3XCURSES), attributes(5), standards(5)

SunOS 5.10			  5 Jun	2002		     initscr(3XCURSES)

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=initscr&sektion=3xcurses&manpath=SunOS+5.10>

home | help