CHARSAVE

8.0.4, ANSI

The CHARSAVE instruction saves the character contents of a screen window into a variable. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

window

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

Flags Affected: EOS

Note the following:

1. The characters are saved starting at the first position of {window}. The Form Pointer is set to one (1) and the Length Pointer is set to the last character moved.

2. If {window} is not large enough to hold the entire subwindow character contents, the EOS flag is set.

3. The screen attributes of each character are not saved.

4. The characters are saved in row major order.

5. The current cursor position is not affected.

6. Use of this instruction on Linux systems requires subwindow emulation in the screen definition file.

See Also: CHARRESTORE, Interactive I/O Instructions