CHARRESTORE

8.0.4, ANSI

The CHARRESTORE instruction (which may be abbreviated as CHARREST) restores the character contents of a screen window. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

window

Required. A previously defined Character String Variable from which the character contents of a screen window is restored.

Flags Affected: LESS

Note the following:

1. If {window} contains fewer characters than fit in the current subwindow, no change is made to the remaining characters of the subwindow.

2. If {window} contains more characters than fit in the current subwindow, only those that fit are displayed.

3. The LESS flag is cleared if {window} contains the exact number of characters to fill the subwindow. Otherwise, the LESS flag is set.

4. The characters are displayed with the currently active screen attributes.

5. The characters are displayed in row major order.

6. The cursor position is set to the home position of the subwindow.

See Also: CHARSAVE, Interactive I/O Instructions