Symbol (programming)

A symbol in computer programming is a primitive datatype whose instances have a unique human-readable form. Symbols can be used as identifiers. In some programming languages, they are called atoms.

In the most trivial implementation, they are essentially named integers (e.g. the enumerated type in C).

Support

The following programming languages provide support for symbols:

language	type name(s)	example literal(s)
ANSI Common Lisp	symbol, keyword	symbol, :keyword
Clojure	symbol, keyword	'symbol, :keyword
Elixir	atom, symbol	:sym
Erlang	atom	sym or 'sym'
Julia	Symbol	:sym
Objective-C	SEL	@selector(sym)
PICAXE BASIC	symbol	symbol let name = variable
Prolog	atom, symbol	sym
Ruby	Symbol	:sym or :'sym'
Scala	scala.Symbol	'symbol
Scheme	symbol	sym
Smalltalk	Symbol	#sym or #'sym'
SML/NJ	Atom.atom
Javascript(ES6)	Symbol	Symbol("sym");

Lisp

A symbol in Lisp is unique in a namespace (or package in Common Lisp). Symbols can be tested for equality with the function EQ. Lisp programs can generate new symbols at runtime. When Lisp reads data that contains textual represented symbols, existing symbols are referenced. If a symbol is unknown, the Lisp reader creates a new symbol.

In Common Lisp symbols have the following attributes: a name, a value, a function, a list of properties and a package.

In Common Lisp it is also possible that a symbol is not interned in a package. Such symbols can be printed, but when read back, a new symbol needs to be created. Since it is not *interned*, the original symbol can't be retrieved from a package.

In Common Lisp symbols may use any characters, including whitespace, such as spaces and newlines. If a symbol contains a whitespace character it needs to be written as |this is a symbol|. Symbols can be used as identifiers for any kind of named programming constructs: variables, functions, macros, classes, types, goto tags and more. Symbols can be interned in a package. Keyword symbols are self-evaluating and interned in the package named KEYWORD.

Examples

The following is a simple external representation of a Common Lisp symbol:

this-is-a-symbol

Symbols can contain whitespace (and all other characters):

|This is a symbol with whitespace|

In Common Lisp symbols with a leading colon in their printed representations are keyword symbols. These are interned in the keyword package.

:keyword-symbol

A printed representation of a symbol may include a package name. Two colons are written between the name of the package and the name of the symbol.

package-name::symbol-name

Packages can export symbols. Then only one colon is written between the name of the package and the name of the symbol.

package:exported-symbol

Symbols, which are not interned in a package, can also be created and have a notation:

#:uninterned-symbol

Prolog

In Prolog, symbols (or atoms) are the primary primitive data types, similar to numbers. The exact notation may differ in different Prolog's dialects. However, it is always quite simple (no quotations or special beginning characters are necessary).

Contrary to other languages, it is possible to give symbols some meaning by creating some Prolog's facts and/or rules.

Examples

The following example demonstrates two facts (describing what father is) and one rule (describing the meaning of sibling). These three sentences use symbols (father, zeus, hermes, perseus and sibling) and some abstract variables (X, Y and Z). The mother relationship has been omitted for clarity.

father(zeus, hermes).
father(zeus, perseus).

sibling(X, Y) :- father(Z, X), father(Z, Y).

Ruby

In Ruby, symbols can be created with a literal form, or by converting a string. They can be used as an identifier or an interned string. Two symbols with the same contents will always refer to the same object. It is considered a best practice to use symbols as keys to an associative array in Ruby.

Examples

The following is a simple example of a symbol literal in Ruby:

my_symbol = :a
my_symbol = :"an identifier"

Strings can be coerced into symbols, vice versa:

my_symbol = "Hello, world!".intern #=> :"Hello, world!"
my_symbol = "Hello, world!".to_sym #=> :"Hello, world!"
my_string = :hello.to_s

Symbols are objects of the Symbol class in Ruby:

my_symbol = :hello_world
my_symbol.length #=> 11
my_symbol.class #=> Symbol

Symbols are commonly used to dynamically send messages to (call methods on) objects:

# same as "aoboc".split("o")
"aoboc".send(:split, "o") #=> ["a", "b", "c"]

Symbols as keys of an associative array:

my_hash = { a: "apple", b: "banana" }
my_hash[:a] #=> "apple"
my_hash[:b] #=> "banana"

Smalltalk

In Smalltalk, symbols can be created with a literal form, or by converting a string. They can be used as an identifier or an interned string. Two symbols with the same contents will always refer to the same object. In most Smalltalk implementations, selectors (method names) are implemented as symbols.

Examples

The following is a simple example of a symbol literal in Smalltalk:

my_symbol := #'an identifier' " Symbol literal "
my_symbol := #a               " Technically, this is a selector literal. In most implementations, "
                              " selectors are symbols, so this is also a symbol literal "

Strings can be coerced into symbols, vice versa:

my_symbol := 'Hello, world!' asSymbol " => #'Hello, world!' "
my_string := #hello: asString         " => 'hello:' "

Symbols conform to the symbol protocol, and their class is called Symbol in most implementations:

my_symbol := #hello_world
my_symbol class            " => Symbol "

Symbols are commonly used to dynamically send messages to (call methods on) objects:

" same as 'foo' at: 2 "
'foo' perform: #at: with: 2 " => $o "