Home > CBM > BASIC > Keywords > Left
180 Subpages: (divide), (equal), (less), (minus), (more), (multiply), (plus), (power), Abs, And, Append, Asc, Atn, Auto, Backup, Bank, Begin, Bend, Bload, Boot, Box, Bsave, Bump, Catalog, Char, Chr, Circle, Close, Clr, Cmd, Collect, Collision, Color, Concat, Cont, Copy, Cos, Data, Dclear, Dclose, Dec, Def, Delete, Dim, Directory, Dispose, Dload, Do, Dopen, Draw, Ds, Ds string, Dsave, Dverify, El, Else, End, Envelope, Er, Err, Exit, Exp, Fast, Fetch, Filter, Fn, For, Fre, Get, Get num, Getkey, Go, Gosub, Goto, Graphic, Gshape, Header, Help, Hex, If, Input, Input num, Instr, Int, Joy, Key, Len, Let, List, Load, Locate, Log, Loop, Mid, Monitor, Movspr, New, Next, Not, Off, On, Open, Or, Paint, Peek, Pen, Pi, Play, Pointer, Poke, Pos, Pot, Print, Print num, Pudef, Quit, Rclr, Rdot, Read, Record, Rem, Rename, Renumber, Restore, Resume, Return, Rgr, Right, Rlum, Rnd, Rreg, Rspcolor, Rsppos, Rsprite, Run, Rwindow, Save, Scale, Scnclr, Scratch, Sgn, Sin, Sleep, Slow, Sound, Spc, Sprcolor, Sprdef, Sprite, Sprsav, Sqr, Sshape, St, Stash, Step, Stop, Str, Swap, Sys, Tab, Tan, Tempo, Then, Ti, Ti string, To, Trap, Troff, Tron, Until, Using, Usr, Val, Verify, Vol, Wait, While, Width, Window, Xor

KeywordAbbreviationToken (hex)Version(s)Classification
LEFT$LE{Shift+F}C81.0Function
The keyword includes the '$' character

 
 Syntax 
LEFT$ source , length )
 
ParametersTypeLegal Value(s)Default ValueNote(s)
sourceString
any (0 to 255 chars)
lengthUnsigned Byte0 to 255   
 
ReturnsTypeValue(s)Note(s)
subStringString
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