Keyword lists

Contents
Keyword syntax
Options pattern
Keyword.get
Keywords vs maps

Keyword syntax

A keyword list is a list of two item tuples with atom first items.

Elixir offers short syntax that drops the braces and the arrows.

Both forms below build the same value, as the equality check proves.

opts = [name: "Ada", loud: true] same = [{:name, "Ada"}, {:loud, true}] opts == same

Options pattern

Libraries accept trailing options so callers pass only what they change.

The function reads each flag by name and falls back when the flag is absent.

Callers write plain pairs, and a loud call tags the greeting while a calm one does not.

def greet(name, opts) do if opts[:loud] do {:loud, name} else {:calm, name} end end greet("Ada", loud: true)

Keyword.get

Keyword get reads one option and accepts a fallback for missing keys.

The fallback keeps callers short, since they skip every default they do not need.

A present flag answers with its value, while a missing flag answers with the fallback.

opts = [loud: true] Keyword.get(opts, :loud, false) Keyword.get(opts, :fast, false)

Keywords vs maps

Keyword lists keep order and allow repeats, while maps keep one value per key with fast lookup.

Options on the way in fit keywords, and stored facts fit maps.

When keys must be atoms and order matters, keywords win the choice.

opts = [tag: 1, tag: 2] Keyword.get_values(opts, :tag) Map.new(opts)

Next: Functions

Article author: Arthur Isaev

Related articles
Elixir
Elixir course: zero to hero in 50 lessons
What is Elixir and where it runs
Install Elixir
iex: the interactive shell
Your first script
Variables
Numbers
Strings
Atoms
Truthiness: only false and nil
Conditions
Recursion replaces loops
Lists
Tuples
Maps
Keyword lists
Functions
Defaults and clauses
Pattern matching
case
with chains
Modules in Elixir
import, alias, require, use in Elixir
Structs in Elixir
Protocols in Elixir
Behaviours in Elixir
The pipe operator in Elixir
Enum in Elixir
Stream in Elixir
Comprehensions in Elixir
Advanced strings in Elixir
Sigils
Binaries and charlists
Exceptions
ok and error tuples
Files and IO
Processes
GenServer
Supervisors
Tasks and Agents
OTP applications
Mix projects
Dependencies
Testing with ExUnit
Doctests
Debugging
Configs
Releases
Capstone: todo CLI
Capstone: HTTP server
Hero roadmap: the whole course on one page
Install Elixir on Windows 11
Install Elixir on Ubuntu
Install Elixir on Rocky Linux
Install Elixir on macOS
Install Elixir on FreeBSD
Elixir in Docker

Search this site

Channel @aofeed Chat @aofeedchat

Contacts and cooperation:
I recommend our hosting beget.com
Write to info@aredel.com if you:
1. Want to write an article for our site or translate an article into your native language.
2. Want to place thematically relevant ads on the site.
3. Ads on my site pass maximum censorship. If you see an ad block unsuitable for school-age children, shocking or misleading - please contact us by e-mail
4. Found a mistake, inaccuracy, bug, etc. on the site. ... .......
5. Articles can be shared on social media by clicking a network icon: