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

  Name:     cls() - clear the entire screen to specified attribute
  Usage:    cls([<attrib>],[<char>])
  Params:   integer <attrib> - the color attribute to clear to
            string <char> - the character to clear to. Optional,
            if left off, then spaces are used.
  Returns:  nothing

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

                 cls(23)
                 * clears the screen to white on blue

                 set color to B/W
                 cls()
                 * clears the screen to blue on white

                 cls(23,chr(177))
                 * clears the screen to white on blue, and
                 * sets all characters to chr(177)

            This next example uses setscreen() to set a virtual screen
            into a screen variable created by savescreen(), and cls() to
            clear that screen without the page being displayed being
            cleared.

                 tempscrn = savescreen()
                 setscreen(temp)
                 cls(23)
                 setscreen()