getwin(3) [netbsd man page]

CURSES_FILEIO(3)					   BSD Library Functions Manual 					  CURSES_FILEIO(3)

NAME

     curses_fileio, getwin, putwin -- curses file input/output routines

LIBRARY

     Curses Library (libcurses, -lcurses)

SYNOPSIS

     #include <curses.h>

     WINDOW *
     getwin(FILE *fp);

     int
     putwin(WINDOW *win, FILE *fp);

DESCRIPTION

     These functions read and write data to and from files.

     The getwin() function reads window data that has been stored in the file to which fp points, and then creates a new window using that data.

     The putwin() function writes window data from the window win to the file pointed to by fp.

RETURN VALUES

     The getwin() function returns one of the following values:

     OK   The function completed successfully.
     ERR  An error occurred in the function.

     The putwin() function returns NULL if an error is detected.

SEE ALSO

     curses_window(3), fread(3), fwrite(3)

NOTES

     Subwindows can not be created by the getwin() function, nor written by the putwin() function.

STANDARDS

     The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification.

HISTORY

     These functions first appeared in NetBSD 5.0.

BSD
								  March 31, 2008							       BSD

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

NAME

       getwin, putwin - read a window from, and write a window to, a file

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 *getwin(FILE *filep);

       int putwin(WINDOW *win, FILE *filep);

DESCRIPTION

       The  getwin()  function	reads window-related data (written earlier by putwin()) from the stdio stream pointed to by filep. It then creates
       and initializes a new window using that data.

       The putwin() function writes all the data associated with the window pointed to by win to  the  stdio  stream  pointed  to  by  filep.  The
       getwin() function can later retrieve this data.

PARAMETERS

       filep	Is a pointer to a stdio stream.

       win	Is a pointer to a window.

RETURN VALUES

       On success, the getwin() function returns a pointer to the new window  created. Otherwise, it returns a null pointer.

       On success, the putwin() function returns OK. Otherwise, it returns 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

       libcurses(3XCURSES), scr_dump(3XCURSES), attributes(5), standards(5)

SunOS 5.11							    5 Jun 2002							  getwin(3XCURSES)