ScreenRetrieve

Syntax

#include <pc.h> void ScreenRetrieve(void *buf);

Description

This function stores a replica of the current primary screen contents in the buffer pointed to by buf. It assumes without checking that buf has enough storage to hold the data. The required storage can be computed as ScreenRows()*ScreenCols()*2 (see section ScreenRows, see section ScreenCols).

Return Value

None.

Portability

ANSI/ISO C	No
POSIX	No

Example

unsigned *saved_screen = (unsigned *)alloca(ScreenRows()*ScreenCols()*2; ScreenRetrieve(saved_screen);