Language Design: Use ident: Type, not Type ident

Published on 2017-07-21.

In expressive languages, developers generally need to use fewer temporary variables. This means that in a typical piece of code there are fewer names defined, but those names carry higher importance.

The ident: Type syntax lets developers focus on the name by placing it ahead of its type annotation. This means that the vertical offset of names stays consistent, regardless of whether a type annotation is present (and how long it is) or not1:

let x: String = "hello"
let y: Float = 23.42
let z = 11
// vs. (hypothetical syntax)
String x = "hello"
Float y = 23.42
var z = 11

In addition to this, there are three technical reasons why ident: Type is superior:

1. Input before output

The i: Int syntax naturally leads to a method syntax where the inputs (parameters) are defined before the output (result type), which in turn leads to more consistency with lambda syntax (whose inputs are also defined before its output).

2. Consistency between definition and usage

The way a class or method is defined should mirror the way it can be used. (See Stop using <> for generics.)

3. Definition before usage

A generic type parameter should be declared before it is used. Otherwise it’s hard to tell to what a type argument refers to:

class Id<T>() {
  // Does the result type T refer to the class' <T> in scope,
  // or to the method's <T> that comes after it?
  T id<T>(T x) { ... }

Language Comparison

As languages have explored various designs2, we can check whether they satisfy the three properties mentioned above:


<T> T id(T x) { ... }


T id<T>(T x) { ... }


fun <T> id(x: T): T { ... }


T id<T>(T x) { ... }


def id[T](x: T): T = ...

Only the last approach delivers all three desirable properties:

  Input before output Definition/usage
Definition before
Java No No Yes
C# No Yes No
Kotlin Yes No Yes
Ceylon No Yes No
Scala Yes Yes Yes
  1. type inference means that the compiler can figure out types without having a developer writing them down explicitly 

  2. focusing on curly-brace languages here, as languages like Haskell, ML and OCaml, Idris have slightly different design optima