Basic syntax walk-through

Define a package

package my.demo // One per file 
 
import std.io.* 
 
// ...

See Packages.

Define a function

// Return type mandatory 
fun sum(a : Int, b : Int) : Int { 
  return a + b 
}

or

// Return type may be inferred 
fun sum(a : Int, b : Int) = a + b

When no meaningful value returned:

fun printSum(a : Int, b : Int) : Unit { 
  print(a + b) 
}

or

// Return type is optional when Unit is intended 
fun printSum(a : Int, b : Int) { 
  print(a + b) 
}

See Functions.
See Hello, world!.

Define a local variable

Assign-once (read-only) local variable:

val a : Int = 1 
val b = 1 // Type is inferred 
val c : Int // Type required when no initializer provided 
c = 1 // definite assignment

Note that semicolons are optional.

Mutable variable:

var x = 5 // Type inferred 
x += 1

Use a string template

fun main(args : Array<String>) { 
  if (args.size == 0) return 
 
  print("First argument: ${args[0]}") 
}

See String templates.
See Arrays.

Use a conditional expression

fun max(a : Int, b : Int) : Int { 
  if (a > b) 
    return a 
  else 
    return b 
}

or

// 'if' is an expression 
fun max(a : Int, b : Int) = if (a > b) a else b

See if expressions.

Null-checks

A reference must be explicitly marked as nullable to be able hold a null:

package multiplier 
 
// Return null if str does not hold a number 
fun parseInt(str : String) : Int? { 
  // ... 
} 
 
fun main(args : Array<String>) { 
  if (args.size < 2) { 
    print("No number supplied"); 
  } 
  val x = parseInt(args[0]) 
  val y = parseInt(args[1]) 
 
  // We cannot say 'x * y' now because they may hold nulls 
 
  if (x != null && y != null) { 
    print(x * y) // Now we can 
  } 
}

or

// ... 
  if  (x == null) { 
    print("Wrong number format in '${args[0]}'") 
    return 
  } 
  if  (y == null) { 
    print("Wrong number format in '${args[1]}'") 
    return 
  } 
  print(x * y) // Now we know that x and y are not nulls

See Null-safety.

`is`-checks and automatic casts

The is operator checks if an expression is an instance of a type (and more). If we is-checked an immutable local variable or property, there's no need to cast it explicitly to the is-checked type:

fun getStringLength(obj : Any) : Int? { 
  if (obj is String) 
    return obj.length // no cast to String is needed   
  return null 
}

or

fun getStringLength(obj : Any) : Int? { 
  if (obj !is String) 
    return null 
  return obj.length // no cast to String is needed 
}

See Classes and Inheritance.
See Type casts.

Use a `for`-loop

fun main(args : Array<String>) { 
  for (arg in args) 
    print(arg) 
 
// or 
 
  for (i in args.indices) 
    print(args[i]) 
}

See for-loops.

Use a `while`-loop

fun main(args : Array<String>) { 
  var i = 0 
  while (i < args.size) 
    print(args[i++]) 
}

See while-loop.

Use pattern-matching

fun cases(obj : Any) { 
  when (obj) { 
    1          -> print("One") 
    "Hello"    -> print("Greeting") 
    is Long    -> print("Long") 
    !is String -> print("Not a string" 
    else       -> print("Unknown") 
  } 
}

See Pattern matching.

Use ranges and `in`

Check if a number lies within a range:

if (x in 1..y-1) 
  print("OK")

Check if a number is out of range:

if (x !in 0..array.lastIndex) 
  print("Out")

Check if a collection contains an object:

if (obj in collection) // collection.contains(obj) is called 
  print("Yes")

Iterate over a range:

for (x in 1..5) 
  print(x)

See Ranges.

Use function literals to filter and map collections

names filter {it.startsWith("A")} sortby {it} map {it.toUpperCase()} foreach {print(it)}

See Higher-order functions and Function literals.

What's next

Address book example

Define a package

Define a function

Define a local variable

Use a string template

Use a conditional expression

Null-checks

is-checks and automatic casts

Use a for-loop

Use a while-loop

Use pattern-matching

Use ranges and in

Use function literals to filter and map collections

What's next

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

Anonymous

`is`-checks and automatic casts

Use a `for`-loop

Use a `while`-loop

Use ranges and `in`