pocketlang/docs/pages/Getting-Started/learn-in-15-minutes.md

# %% Learn pocketlang in 15 minutes %%

```ruby

# This is a comment.

x = 0  # Creating a variable.

# In pocketlang statements should end with a new line
# or a semicolon. White space characters except for new
# lines are ignored in pocketlang.
a = 1; b = 2;

# Data types.
# -----------

null                   # A null type.
true; false            # Booleans.
42; 3.14               # Numbers.
0..10; 10..0           # Range (0..10 = 0 <= r < 10).
"hello"; 'world'       # Strings (support multiline).
[42, 'foo', null]      # Lists.
{ 'Key':'value' }      # Maps.
func(x) return x*x end # Lambda/literal functions.

# Control flow.
# -------------

# If condition.
if x == 'foo'
	print('bar')
elsif x == 'bar'
	print('baz')
end

# In a single line (should add 'then' keyword).
if x == 'foo' then print('bar') end

# For loops, here 'do' keyword is optional if we have a
# newline after the sequence (like 'then' in if statements).
for i in 0..10 do
	print(i)
end

# While statement.
while x > 0 do print(x -= 1) end

# In pocketlang variable's lifetime are scope based.
if true then
	local = null
end
#print(local) # Error: Name 'local' is not defined.

# Functions.
#-----------

def add(a, b)
	return a + b
end

# Functions can be assigned to a variable.
fn = func(x) return x*x end

# Functions can be passed as an argument and can be returned.
def call(fn, x)
	fn(x)
	return func print('foo') end
end

# Classes (WIP)
#--------------

class _Vector
  x = 0; y = 0
end

def Vector(x, y)
  ret = _Vector()
  ret.x = x; ret.y = y
  return ret
end

def vecAdd(v1, v2)
  return Vector(v1.x + v2.x,
                v1.y + v2.y)
end

v1 = Vector(1, 2)
v2 = Vector(3, 4)
v3 = vecAdd(v1, v2)
print(v3) # [_Vector: x=4, y=6]

# Fibers & Coroutine
#-------------------

import Fiber

def fn(p1, p2)
	print(yield(42)) # Prints 3.14
end

fb = Fiber.new(fn)
val = Fiber.run(fb, 1, 2)
print(val) ## Prints 42
Fiber.resume(fb, 3.14)
```