Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

putwin(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
Committed
MT-Level
Unsafe
Standard

See Also

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