Crash course in Erlang

This is a summary of a talk I held Monday May 14 2012 at an XP Meetup in Trondheim. It is meant as a teaser for listeners to play with Erlang themselves.

First, some basic concepts. Erlang has a form of constant called atom that is defined on first use. They are typically used as enums or symbols in other languages. Variables in Erlang are immutable so assigning a new value to an existing variable is not allowed

1> A = 1.
2> A = 2.
** exception error: no match of right hand side value 2
3> A = 1.

The third statement shows that the assignment is actually a pattern match, but the first statement assigns a value to the variable.

Lists and property lists are central in Erlang. The lists behave much like lists in other functional languages or arrays in other types of languages. Property lists are a special type of list that is used as a hash or dict in other languages

1> A = [1,2,3,4,5,6,7].
2> lists:nth(1, A).
3> lists:nth(7, A).
4> lists:last(A).
5> length(A).
6> [Head|Tail] = A.
7> Head.
8> Tail.

The Erlang shell is useful and when defining a module, it can be compiled and run directly from the shell. Fibonacci numbers are an easy demonstration of the capabilities of a functional language.



fib(0) -> 0;
fib(1) -> 1;
fib(N) -> fib(N - 1) + fib(N - 2).

Compile and test

1> c(fib).
2> lists:foreach(fun(N) -> io:format("fib ~p = ~p~n", [N, fib:fib(N)]) end, [1,2,3,4,5,6,7]).
fib 1 = 1
fib 2 = 1
fib 3 = 2
fib 4 = 3
fib 5 = 5
fib 6 = 8
fib 7 = 13



Erlang has a very powerful messaging system. This system supports distributed messaging.

First, a simple message loop that isn’t really a loop at all. Calling loop:init() will spawn a separate process waiting to receive messages.

1> c(loop).
2> Pid = loop:init().
3> loop:ping(Pid).
4> flush().
Shell got {pong,<0.39.0>}
5> loop:ping(Pid).
6> flush().

The first time the loop is pinged, it replies pong, but the second time, nothing happens. When a message is received, the loop function will finish.


Message receive statements in Erlang may time out:

2> Pid = loop1:init().
I have decided to die

The message loop times out after 1000 millisecond and exits the function.

An actual message loop

Let’s convert the message handling function loop into a real loop through tail recursion. Tail recursion means this loop can run forever without the growing stack otherwise caused by recursion.

1> c(loop2).
2> Pid = loop2:init().
3> loop2:ping(Pid).
4> loop2:ping(Pid).
5> flush().
Shell got {pong,<0.39.0>}
Shell got {pong,<0.39.0>}
6> loop2:ping(Pid).
7> flush().
Shell got {pong,<0.39.0>}

Calling ping multiple times means we get multiple replies as we should from a message loop.

Calling stop terminates the message loop.

8> loop2:stop(Pid).
9> loop2:ping(Pid).
10> flush().        


While Erlang is a functional language and should be stateless, we may insert state into our message loop. Note that the variable State in the example never change value within a context.

1> c(loop3).
2> Pid = loop3:init().
3> loop3:ping(Pid).
4> loop3:ping(Pid).
5> loop3:ping(Pid).
6> flush().
Shell got {pong,<0.39.0>,0}
Shell got {pong,<0.39.0>,1}
Shell got {pong,<0.39.0>,2}
7> loop3:stop(Pid).
Final state = 3

Every ping leads to an increment of State and stop prints the final value.

Distributed messaging

First, we start an Erlang shell with the short name left and a cookie meetup. The cookie is used by the shells to find each other.

erl -sname left -setcookie meetup
Then start the loop in this shell.

(left@localhost)1> c(loop4).
(left@localhost)2> loop4:init().

Observe that the prompt includes the shortname of the node.

Start a new shell called right with the same cookie:
erl -sname right -setcookie meetup

Send messages to the loop running in the other shell and observe the response

(right@localhost)1> loop4:ping(left@localhost).
Got 0 from <6032.45.0>
(right@localhost)2> loop4:ping(left@localhost).
Got 1 from <6032.45.0>

Sending stop terminates the loop

(right@localhost)3> loop4:stop(left@localhost).

This causes the following output in the left shell

Final state = 2

OTP or at least generic servers

It’s hard to talk about Erlang and messaging without at least touching OTP and generic servers. A module defining a generic server needs to specify -behaviour(gen_server) and define some functions used by the generic server framework. This file also introduces Erlang macros as a built-in macro ?MODULE is used here. ?MODULE contains the name of the module as an atom.

The functions representing an API to this server are count, increment, start_link and stop. We start the server by calling start_link and then call count and increment to see what happens.

1> c(gobbler).
2> gobbler:start_link().
3> gobbler:count().
4> gobbler:count().
5> gobbler:increment().
6> gobbler:increment().
7> gobbler:count().

No surprises there. When gobbler:count is called, gen_sever:call(?MODULE, count) sends the message count to the message loop of the server. The message loop calls handle_call(count, From, State) with From identifying the caller and State containing the State variable which is set to 0 in init called by start_link. handle_call(count, From, State) returns {reply, State, State} with reply being mandatory in a call to indicate that the loop should send a reply to the caller, the first State is the message returned to the caller and the last State is the new value of the State variable to send into the next iteration of the loop.

gobbler:increment uses gen_server:cast(?MODULE, increment) to send an increment message to the server. Cast sends the message and forgets it, meaning the caller will not expect a reply or even wait for one.

Selection of the right handle_cast is a result of pattern matching. increment matches the first handle_cast so it is executed. A cast of stop would have matched the second one.

2 thoughts on “Crash course in Erlang

  1. Err, second paragraph:

    “Variables in Erlang are *mutable* so assigning a new value to an existing variable is not allowed”

    Should read:

    “Variables in Erlang are *immutable* so assigning a new value to an existing variable is not allowed”

    Next paragraph: “first match assigns a value to the variable.” -> “first statement assigns a value to the variable.”

    A bit further on: “Fibonacci is always a nice way to show things in a functional language.” -> “Fibonacci numbers are an easy demonstration the capabilities of a functional language.”

    And I would put in the URL to the Wikipedia articles on Fibonacci numbers, Most of your readers will know the sequence but some may not or may not remember it clearly.

    Sorry, had to stop here to write reviews and some blog posts. Will be mentioning your post as a resource on Erlang on my blog.

  2. Thanks a lot for those corrections. Looks like I was in too much of a hurry writing this down. I have corrected the errors you pointed out and fixed a couple of more that I found now as well.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.