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

CLEOL()

Syntax:     CLEOL([<expN1>][,<expN2>])

Arguments:  <expN1> determines the line in which the erasure takes
            place (default: cursor line).
            <expN2> determines the column from which the erasure takes
            place (default: cursor column).

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

Usage:      The CLEOL() 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
            CLEOL() give an increase in speed compared to
            CLEAREOL().  The function also ignores the setting of
            CLEARA and CLEARB, giving a further speed increase.  The
            CLEOL() 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...CLEAREOL()).
            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 function will automatically default to the actual cursor
            position if no arguments are specified for lines or columns.

Library:    CT1.LIB


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

Examples:   * Erase from current  cursor position to end
            * of line.
            CLEOL()

            * In line 23, erase from the cursor column
            * position to the end of the line.
            CLEOL(23)

            * In line 23, erase from column 15 to the
            * end of the line.
            CLEOL(23,15)