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 Committed MT-Level Unsafe Standard See standards(5).

See also

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