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

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

===== LEFT ✓ =====

===== SYNTAX =====
     = LEFT( text, position )

==== PURPOSE ====


The ''LEFT'' command replaces the leftmost characters in the 
destination string with the equivalent characters from the given
strings. The command has two parameters. 

The first parameter is the string expression to change. 

The second parameter is a numeric expression, indicating how 
many characters to return. If 0, an empty string (''""'') is returned. 
On the other hand, if greater than or equal to the number of characters 
in string, the entire string is returned, untouched. 

To determine the number of characters in string, you should use 
the ''LEN'' function.



==== EXAMPLE ====
    x = LEFT( "TEST", 2 )


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


==== ABBREVIATION ====
   Lf


==== 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


==== SEE ALSO ====
[[RIGHT (function)]] [[RIGHT]] [[MID (function)]] [[MID]] [[LEN]] 

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

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