{{htmlmetatags>metatag-robots=()
metatag-title=(CLS | ugBASIC User Manual)
metatag-keywords=(ugBASIC,Commodore 64,Commodore PLUS/4,ZX Spectrum)
metatag-description=(Manual page for CLS)
metatag-media-og:image=(:ugbasic:logo-ugbasic-fb.png)
metatag-og:title=(CLS | ugBASIC User Manual) 
metatag-og:description=(Manual page for CLS)
}}

====== ugBASIC User Manual ======

===== CLS ✓ =====

===== SYNTAX =====
     CLS
     CLS [color]

==== PURPOSE ====





The ''CLS'' command clears the screen, setting it (possibly) to a given background color. 
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.



==== EXAMPLE ====
    CLS
    CLS WHITE


See also the following example files:
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/texts_position_01.bas|texts_position_01.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/texts_position_02.bas|texts_position_02.bas]]''


==== ABBREVIATION ====
   Cl


==== AVAILABLE ON ====
  * Dragon 32
  * Commodore 128 (Zilog Z80)
  * Commodore 128 (MOS 8502)
  * SEGA SG-1000
  * ZX Spectrum 48
  * Commodore 64
  * Commodore VIC-20
  * Atari (400/800)
  * 
  * Commodore PLUS/4
  * VG-5000
  * Olivetti Prodest PC128
  * Dragon 64
  * Amstrad CPC 664
  * SEGA SC-3000
  * ColecoVision
  * TRS-80 Color Computer 3
  * MSX
  * TRS-80 Color Computer


==== ANY PROBLEM? ====
If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please [[https://github.com/spotlessmind1975/ugbasic/issues/new?title=ISSUE ON CLS|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

[[:ugbasic:user:index|{{ :ugbasic:user:logo-ugbasic.png?nolink&600 |}}]]