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

CLWIN()

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

Arguments:  <expN1> determines the starting line to erase from (default:
            cursor line).
            <expN2> denotes the first column to erase from (default:
            cursor column).
            <expN3> determines the last line to be erased (default: last
            screen or window line).
            <expN4> denotes the last column to be erased (default:
            right-hand edge of screen or window).

Returns:    A character string.
            A null string is returned.

Usage:      The CLWIN() function can be used if it is required to erase
            (to black) without using the standard attributes and  character.
            This function is particularly useful with monochrome screens.
            The omission of the arguments <attr> and <char> in
            CLWIN() give an increase in speed compared to
            CLEARWIN().  The function also ignores the setting of
            CLEARA and CLEARB, giving a further speed increase.  The
            CLWIN() functions have certain advantages compared to the
            Clipper @ command:

            1.  It is a function returning a null string so can be combined
                with string outputs.  (LIST...CLWIN()).
            2.  The cursor position will not be changed.
            3.  The arguments are optional.  The function will erase
                from the current cursor position if they are not specified.

Notes:      The arguments are optional.  If they are not indicated the
            functions will erase from the current cursor position.

Library:    CT1.LIB


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

Examples:   * Erase from the actual cursor position to
            * the end of the screen.
            CLWIN()

            * Ditto for the actual column position in
            * line 23
            CLWIN(23)

            * From line 23, column 15, erase to the end
            * of line 24.
            CLWIN*23,15,24)

            * Erase a window between line 23, column 15
            * and line 24, column 70.
            CLWIN(23,15,24,70)