====== LSHIFT() ======

//Since version 2.1//

Syntax:

  lshift!(<byte expression> [, <byte positions>])
or
  lshift(<int expression> [, <byte positions>])
  
The ''LSHIFT()'' function shifts each bit in //expression// to the left by the number of //positions// and returns the result of the operation. 

The second argument can be omitted and it defaults to 1.

Warning: passing //positions// bigger than 127 will lead to undefined results.

===== Performance tip =====

Shifting the bits to the left is equivalent to multiplying with powers of two, however much faster. Example:

  rem -- this is slow
  x = 75
  y = x * 4
  
  rem -- this is fast
  x = 75
  y = lshift(x, 2)