Click above to get retro games delivered to your door ever month!

SCREENSTR()

Syntax:     SCREENSTR([<expN1>][,<expN2>][,<expN3>])

Arguments:  <expN1> specifies the first line to be read from (default:
            cursor line).
            <expN2> specifies the first column to be read (default:
            cursor column).
            <expN3> will determine the number of symbols to be read
            (default: to  the end of the screen or window area).

Returns:    A character string.
            The string will contain all the bytes that were read by the
            screen.

Usage:      With SCREENSTR() it is possible for the screen or window
            contents to be entirely, or partly copied into a variable.
            <expN1> will determine the first line, and <expN2> the
            first column from which to read.  <expN3> can be used to
            limit the number of symbols to be read.

Notes:      The string returned will also contain the attribute bytes.  The
            size of the variable for the total screen contents will be 25
            lines by 80 columns: a total of 4000 bytes.  If <expN1> or
            <expN2> are not specified, the function will
            automatically use the actual cursor position.  The function will
            not cause any change in the actual cursor position.

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   * Read all the characters and corresponding
            * attributes from the cursor position to the
            * end of the screen.
            var = SCREENSTR()

            * All symbols and attributes from the cursor
            * position in line 24.
            var = SCREENSTR(24)

            * The last 10 symbols and attributes from
            * line 24.
            var = SCREENSTR(24,70)

            * The last 10 symbols (without attributes) in
            * line 24.
            var = CHARODD(SCREENSTR(24,70))