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(7) for descriptions of the following attributes:


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

SEE ALSO

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

June 5, 2002 GETWIN(3XCURSES)