Available on: d32 c128z c128 sg1000 zx c64 vic20 atari to8 plus4 vg5000 pc128op d64 cpc pc1403 sc3000 coleco coco3 msx1 coco
Alias: PCLS

CLS

The CLS command is used to clear the screen and return the cursor to the upper left corner. In other words, CLS clears the screen, eliminating everything that was previously printed.

Before printing new data to the screen, it is often useful to use CLS to have a clean and tidy space. In combination with other instructions, CLS can be used to create simple animations by erasing and redrawing elements on the screen. It allows you to update the user interface without leaving traces of previous operations.

The CLS command is generally very fast to execute and can also be used in graphics mode to clear the entire drawing area. It also has the ability to set a default background color, if possible. The clearing occurs with respect to the selected mode, so it will be a "pixel by pixel" clearing (if in bitmap mode) or "tile by tile" (if in tile mode). In the second case, the value of the EMPTYTILE variable will be used, possibly overridden

SYNTAX

 CLS
 CLS color


Legend
  • id : identifier
  • type : datatype
  • v : value
  • "..." : string
  • [...] : optional

ABBREVIATION: Cl

Join BASIC 10Liner Contest with ugBASIC!

An interesting competition is held at the beginning of each year: the BASIC 10Liner Contest. It is possible to use ugBASIC to participate in the next "BASIC10Liner" competition, in the following categories:

  • PUR-120 - A game in 10 lines of max 120 characters (w/abbrev.)
  • EXTREME-256 - A game in 10 lines of max 256 characters (w/abbrev.)
  • SCHAU - Any program in 10 lines of max 256 characters (w/abbrev.)
In order to reduce space you can use this abbreviation for this instruction:

CLS ↔ Cl

Any problem?

If you have found a problem with this keyword, if you think there is a bug or, more simply, you would like it to be improved, open an issue for this example on GitHub.
Thank you!

open an issue BACK TO KEYWORDS