Citrine (programming language)

Citrine has a very limited syntax and it's very closely related to Smalltalk. Everything in Citrine is an object, there are 5 literals:

• Nil
• True, False
• 0,1,2,3
• 'String'
• { ...params.. ...block of code... }

The code block literal uses a pipe symbol to separate the parameters from the logic '|', if there are no parameters, the backslash should be used instead of '\'.

Citrine only supports full-line comments, comments start with a '#'.

A Citrine program is basically a sequence of messages sent to objects. For instance, to determine whether 5 is an even number, the message 'even?' is sent to the number 5.

5 even?

This is called a unary message because it takes no arguments. A binary message is always a single UTF-8 character; this differs from Smalltalk, where there is a fixed set of binary messages. Here is an example:

6 + 7.

Here a binary message '+' is sent to number 6, the argument of this binary message is '7', this will result in a new number object '13'. Assigning the outcome of this operation to a variable uses the assignment operator: :=.

total := money + debt.

Also note that each line in a Citrine program ends with a dot, just like in Smalltalk. Besides unary and binary messages, Citrine offers keyword messages, which take arguments interspersed with the message itself just like Smalltalk and Objective-C.

☞ x := Number between: 1 and: 5.

The code snippet above will return a boolean object True.

Just like Smalltalk, control flow in Citrine is implemented by strategic use of messages. For instance, writing a conditional statement requires sending a block of code to a boolean.

(money > price) true: { ✎ write: 'Yes, you can afford this'. }.

Likewise, a for-loop is written as:

{ :step ✎ write: 'this is step:' + step. } * 10.

To break out of a loop in Citrine one has to send the message 'break' to a boolean, this allows a conditional break from a loop without having to factor out the break conditions:

{ :i
  (i = 3) break.
  ✎ write: i.
} * 5.

Unlike Smalltalk, Citrine has no semi-colon to send a message to the original receiver. Instead Citrine has a comma token ',' used to chain keyword messages, this allows writing Unix-like pipelines. The following code uses a pipeline-like syntax to replace all the 'o' characters with zeroes, the resulting string would be something like: '1010101...'.

onesAndZeroes := '1o1o1o1o1o1' split: 'o', map: mapUp, join: '0'.

The biggest difference from Smalltalk is the use of prototypes. Citrine does not have a concept of a class, it only knows about objects. An object is created using the new message:

cat := Object new.

This object can be made to respond to messages by ordering the object to listen to events. This is kind of similar to adding methods in languages like Java:

cat on: 'meow' do: { 
  Pen write: 'meow!'.
}.

As stated above, inheritance is based on prototypes. To derive an object from another object, the new message must be sent to the object to be extended:

☞ Animal := Object new.
Animal on: 'makeSound' do: {
	✎ write: '?'.
}.
☞ Cat := Animal new.
Cat on: 'makeSound' do: {
	✎ write: 'meow!'.
}.
☞ Tom := Cat new.
Tom makeSound.

Citrine uses UTF-8 unicode extensively, both objects and messages can consist of unicode symbols. All string length are calculated using UTF-8. Citrine distinguishes string length and size in bytes:

'text' length.

returns the length of the string in UTF-8 code pointes, while:

'text' bytes.

returns the number of bytes.

Citrine uses dynamic scoping instead of lexical scoping. Thus, there is no need for dependency injection or global variables, but it might be harder to reason about than lexical scope. This is similar in programming languages like Emacs Lisp and BASIC. In code blocks the var keyword needs to be used to declare a local variable.

The following demonstration makes the Mailer object available in the module:

Application := {
   ☞ mailer := Mailer new.
   module run.
}.

• Smalltalk programming language

• demo in new programming languages community
• Citrine Review Jaxenter
• Announcement on Reddis
• InfoWorld interview

• Official website
• source code, Source code on github