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

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

===== IF  =====

===== SYNTAX =====
     = IF (exp, valueTrue, valueFalse )

==== PURPOSE ====



The ''IF'' function allows you to evaluate whether a certain expression is ''TRUE'' (not 0) or ''FALSE''. 
(0). Depending on that check, the function will return the second (if ''TRUE'') or third (if ''FALSE'') 
argument. 

This function evaluates the expression at compile time: it follows that the return 
value does not change at runtime. There are three versions of this function, one for each 
type of value that can be returned. There is a version that returns integers, one for 
floating point numbers, and one for strings.

This function is particularly useful for carrying out a conditional evaluation of constants which, 
otherwise, would require evaluation at runtime, wasting time and occupying useless space.



==== EXAMPLE ====
    pictureToUse = IF(SCREEN WIDTH > 160, "large.png", "small.png" )


==== ABBREVIATION ====
   If


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


==== 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 IF|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

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