Commodore‎ > ‎BASIC‎ > ‎Keywords‎ > ‎

LEFT$

Keyword Abbreviation Token (hex) Version(s) Classification
LEFT$ LE{Shift+F} C8 1.0 Function
The keyword includes the '$' character

 
  Syntax  
LEFT$ source , length )
 
Parameters Type Legal Value(s) Default Value Note(s)
source String
any (0 to 255 chars)
length Unsigned Byte 0 to 255     
 
Returns Type Value(s) Note(s)
subString String
0 to length characters
 
  Purpose  
Return the the left-most character(s) from a source string.
 
  Remarks  
LEFT$ is one of the three string-splicing functions provided by BASIC (these complement string concatenation with the + operator).  LEFT$ returns a subString with (upto) length characters from the begining (left side) of the source string.
 
If length specifies more characters than exist in source, the entire source is returned and there is no error.  If length is omitted or not a valid expression, SYNTAX ERROR occurs.  If length is not numeric, TYPE MISMATCH ERROR occurs.  If length is not a legal value (see above) an ILLEGAL QUANTITY ERROR happens.
 
If source is omitted or not a valid expression, SYNTAX ERROR occurs.  If source is not a string, TYPE MISMATCH ERROR occurs; the STR$ function can be used to convert a number into a string.
 
Examples:
PRINT LEFT$(100.8, 2)

?TYPE MISMATCH ERROR 
READY.
PRINT LEFT$("100.8", 2)
10
 
READY.
PRINT LEFT$("CBM", 16)
CBM

READY.
 
  Compare With  
 
  Contrast With  
 
  See Also  

© H2Obsession, 2014
Comments