Lisp Flavored Erlang (LFE) is a
functional,
concurrent,
garbage collected
Garbage, trash, rubbish, or refuse is waste material that is discarded by humans, usually due to a perceived lack of utility. The term generally does not encompass bodily waste products, purely liquid or gaseous wastes, or toxic waste produ ...
, general-purpose
programming language
A programming language is a system of notation for writing computer programs. Most programming languages are text-based formal languages, but they may also be graphical. They are a kind of computer language.
The description of a programming l ...
and
Lisp
A lisp is a speech impairment in which a person misarticulates sibilants (, , , , , , , ). These misarticulations often result in unclear speech.
Types
* A frontal lisp occurs when the tongue is placed anterior to the target. Interdental lispi ...
dialect
The term dialect (from Latin , , from the Ancient Greek word , 'discourse', from , 'through' and , 'I speak') can refer to either of two distinctly different types of linguistic phenomena:
One usage refers to a variety of a language that ...
built on Core
Erlang and the Erlang virtual machine (
BEAM). LFE builds on Erlang to provide a Lisp syntax for writing distributed,
fault-tolerant, soft
real-time, non-stop applications. LFE also extends Erlang to support
metaprogramming
Metaprogramming is a programming technique in which computer programs have the ability to treat other programs as their data. It means that a program can be designed to read, generate, analyze or transform other programs, and even modify itself ...
with Lisp macros and an improved developer experience with a feature-rich
read–eval–print loop
A read–eval–print loop (REPL), also termed an interactive toplevel or language shell, is a simple interactive computer programming environment that takes single user inputs, executes them, and returns the result to the user; a program written ...
(REPL). LFE is actively supported on all recent releases of Erlang; the oldest version of Erlang supported is R14.
History

Initial release
Initial work on LFE began in 2007, when Robert Virding started creating a prototype of Lisp running on Erlang.
This work was focused primarily on parsing and exploring what an implementation might look like. No version control system was being used at the time, so tracking exact initial dates is somewhat problematic.
Virding announced the first release of LFE on the ''Erlang Questions'' mail list in March 2008. This release of LFE was very limited: it did not handle recursive
letrec
s,
binary
s,
receive
, or
try
; it also did not support a Lisp shell.
Initial development of LFE was done with version R12B-0 of Erlang
on a Dell XPS laptop.
Motives
Robert Virding has stated that there were several reasons why he started the LFE programming language:
* He had prior experience programming in Lisp.
* Given his prior experience, he was interested in implementing his own Lisp.
* In particular, he wanted to implement a Lisp in Erlang: not only was he curious to see how it would run on and integrate with Erlang, he wanted to see what it would ''look'' like.
* Since helping to create the Erlang programming language, he had had the goal of making a Lisp which was specifically designed to run on the BEAM and able to fully interact with Erlang/OTP.
* He wanted to experiment with
compiling another language on Erlang. As such, he saw LFE as a means to explore this by generating Core Erlang and plugging it into the backend of the Erlang compiler.
Features
* A language targeting
Erlang virtual machine (BEAM)
* Seamless
Erlang integration: zero-penalty Erlang function calls (and vice versa)
* Metaprogramming via
Lisp macros and the
homoiconicity of a Lisp
*
Common Lisp
Common Lisp (CL) is a dialect of the Lisp programming language, published in ANSI standard document ''ANSI INCITS 226-1994 (S20018)'' (formerly ''X3.226-1994 (R1999)''). The Common Lisp HyperSpec, a hyperlinked HTML version, has been derived fr ...
-style documentation via both source code
comments
Comment may refer to:
* Comment (linguistics) or rheme, that which is said about the topic (theme) of a sentence
* Bernard Comment (born 1960), Swiss writer and publisher
Computing
* Comment (computer programming), explanatory text or informa ...
and docstrings
*
Shared-nothing architecture concurrent programming via message passing (
Actor model)
* Emphasis on
recursion
Recursion (adjective: ''recursive'') occurs when a thing is defined in terms of itself or of its type. Recursion is used in a variety of disciplines ranging from linguistics to logic. The most common application of recursion is in mathematic ...
and
higher-order functions instead of
side-effect
In medicine, a side effect is an effect, whether therapeutic or adverse, that is secondary to the one intended; although the term is predominantly employed to describe adverse effects, it can also apply to beneficial, but unintended, consequence ...
-based
looping
* A full
read–eval–print loop
A read–eval–print loop (REPL), also termed an interactive toplevel or language shell, is a simple interactive computer programming environment that takes single user inputs, executes them, and returns the result to the user; a program written ...
(REPL) for interactive development and testing (unlike Erlang's shell, the LFE REPL supports function and macro definitions)
*
Pattern matching
In computer science, pattern matching is the act of checking a given sequence of tokens for the presence of the constituents of some pattern. In contrast to pattern recognition, the match usually has to be exact: "either it will or will not be ...
* Hot loading of code
* A
Lisp-2
LISP 2 was a programming language proposed in the 1960s as the successor to Lisp. It had largely Lisp-like semantics and Algol 60-like syntax. Today it is mostly remembered for its syntax, but in fact it had many features beyond those of early Lisp ...
separation of namespaces for variables and functions
*
Java
Java (; id, Jawa, ; jv, ꦗꦮ; su, ) is one of the Greater Sunda Islands in Indonesia. It is bordered by the Indian Ocean to the south and the Java Sea to the north. With a population of 151.6 million people, Java is the world's mo ...
inter-operation via JInterface and Erjang
*
Scripting
Script may refer to:
Writing systems
* Script, a distinctive writing system, based on a repertoire of specific elements or symbols, or that repertoire
* Script (styles of handwriting)
** Script typeface, a typeface with characteristics of handw ...
abilities with both
lfe
and
lfescript
Syntax and semantics
Symbolic expressions (S-expressions)
Like Lisp, LFE is an
expression-oriented language. Unlike non-
homoiconic programming languages, Lisps make no or little syntactic distinction between ''expressions'' and ''
statements'': all code and data are written as expressions. LFE brought homoiconicity to the Erlang VM.
Lists
In LFE, the list data type is written with its elements separated by whitespace, and surrounded by parentheses. For example, is a list whose elements are the integers and , and the atom
. These values are implicitly typed: they are respectively two integers and a Lisp-specific data type called a ''symbolic atom'', and need not be declared as such.
As seen in the example above, LFE expressions are written as lists, using
prefix notation. The first element in the list is the name of a ''form'', i.e., a function, operator, or macro. The remainder of the list are the arguments.
Operators
The LFE-Erlang operators are used in the same way. The expression
(* (+ 1 2 3 4 5 6) 2)
evaluates to 42. Unlike functions in Erlang and LFE, arithmetic operators in Lisp are
variadic In computer science, an operator or function is variadic if it can take a varying number of arguments; that is, if its arity is not fixed.
For specific articles, see:
* Variadic function
* Variadic macro in the C preprocessor
* Variadic template
* ...
(or ''n-ary''), able to take any number of arguments.
Lambda expressions and function definition
LFE has ''lambda'', just like Common Lisp. It also, however, has ''lambda-match'' to account for Erlang's pattern-matching abilities in anonymous function calls.
Erlang idioms in LFE
This section does not represent a complete comparison between Erlang and LFE, but should give a taste.
Pattern matching
Erlang:
1> = .
2> Msg.
"Trillian"
LFE:
> (set (tuple len status msg) #(8 ok "Trillian"))
#(8 ok "Trillian")
> msg
"Trillian"
List comprehensions
Erlang:
1> , X <- .
[1,3,9,27">,1,2,3.
[1,3,9,27
LFE:
> (list-comp
((<- x '(0 1 2 3)))
(trunc (math:pow 3 x)))
(1 3 9 27)
Or idiomatic functional style:
> (lists:map
(lambda (x) (trunc (math:pow 3 x)))
'(0 1 2 3))
(1 3 9 27)
Guards
Erlang:
right_number(X) when X 42; X 276709 ->
true;
right_number(_) ->
false.
LFE:
(defun right-number?
((x) (when (orelse ( x 42) ( x 276709)))
'true)
((_) 'false))
cons'ing in function heads
Erlang:
sum(L) -> sum(L,0).
sum([], Total) -> Total;
sum([H, T], Total) -> sum(T, H+Total).
LFE:
(defun sum (l) (sum l 0))
(defun sum
(('() total) total)
(((cons h t) total) (sum t (+ h total))))
or using a ``cons`` literal instead of the constructor form:
(defun sum (l) (sum l 0))
(defun sum
(('() total) total)
((`(,h . ,t) total) (sum t (+ h total))))
Matching records in function heads
Erlang:
handle_info(ping, #state = State) ->
gen_server:cast(self(), ping),
;
handle_info(ping, State) ->
;
LFE:
(defun handle_info
(('ping (= (match-state remote-pid 'undefined) state))
(gen_server:cast (self) 'ping)
`#(noreply ,state))
(('ping state)
`#(noreply ,state)))
Receiving messages
Erlang:
universal_server() ->
receive
->
Func()
end.
LFE:
(defun universal-server ()
(receive
((tuple 'become func)
(funcall func))))
or:
(defun universal-server ()
(receive
(`#(become ,func)
(funcall func))))
Examples
Erlang interoperability
Calls to Erlang functions take the form ''(
: ... )'':
(io:format "Hello, World!")
Functional paradigm
Using recursion to define the Ackermann function:
(defun ackermann
((0 n) (+ n 1))
((m 0) (ackermann (- m 1) 1))
((m n) (ackermann (- m 1) (ackermann m (- n 1)))))
Composing functions:
(defun compose (f g)
(lambda (x)
(funcall f
(funcall g x))))
(defun check ()
(let* ((sin-asin (compose #'sin/1 #'asin/1))
(expected (sin (asin 0.5)))
(compose-result (funcall sin-asin 0.5)))
(io:format "Expected answer: ~p~n" (list expected))
(io:format "Answer with compose: ~p~n" (list compose-result))))
Concurrency
Message-passing with Erlang's light-weight "processes":
(defmodule messenger-back
(export (print-result 0) (send-message 2)))
(defun print-result ()
(receive
((tuple pid msg)
(io:format "Received message: '~s'~n" (list msg))
(io:format "Sending message to process ~p ...~n" (list pid))
(! pid (tuple msg))
(print-result))))
(defun send-message (calling-pid msg)
(let ((spawned-pid (spawn 'messenger-back 'print-result ())))
(! spawned-pid (tuple calling-pid msg))))
Multiple simultaneous HTTP requests:
(defun parse-args (flag)
"Given one or more command-line arguments, extract the passed values.
For example, if the following was passed via the command line:
$ erl -my-flag my-value-1 -my-flag my-value-2
One could then extract it in an LFE program by calling this function:
(let ((args (parse-args 'my-flag)))
...
)
In this example, the value assigned to the arg variable would be a list
containing the values my-value-1 and my-value-2."
(let ((`#(ok ,data) (init:get_argument flag)))
(lists:merge data)))
(defun get-pages ()
"With no argument, assume 'url parameter was passed via command line."
(let ((urls (parse-args 'url)))
(get-pages urls)))
(defun get-pages (urls)
"Start inets and make (potentially many) HTTP requests."
(inets:start)
(plists:map
(lambda (x)
(get-page x)) urls))
(defun get-page (url)
"Make a single HTTP request."
(let* ((method 'get)
(headers '())
(request-data `#(,url ,headers))
(http-options ())
(request-options '(#(sync false))))
(httpc:request method request-data http-options request-options)
(receive
(`#(http #(,request-id #(error ,reason)))
(io:format "Error: ~p~n" `(,reason)))
(`#(http #(,request-id ,result))
(io:format "Result: ~p~n" `(,result))))))
References
External links
*
*
LFE Quick Start
LFE User Guide
LFE on Rosetta Code
{{Lisp programming language
Programming languages
Pattern matching programming languages
Lisp programming language family