Programming Guide

Restores previously saved data to the screen

int sm_restore_data(char *buffer);

buffer

The address of an area initialized by sm_save_data that contains the data to restore. Data items are stored in buffer as null-terminated character strings. The contents of a scrollable array is preceded by 2 bytes giving the total number of items saved (high order byte first); each item is preceded by two bytes of display attribute, and followed by a null. There is an additional null following all the scrolling data.

C only

• 0 Success.

• -1 Error, usually memory allocation failure.

sm_restore_data restores all data items, on- and off-screen, to the current screen from buffer, previously initialized by sm_save_data. Passing a buffer not returned by sm_save_data, or attempting to restore to a screen other than the one saved, can yield unpredictable results.

sm_save_data, sm_sv_free

---

---