Tasks and Agents

Contents
Task.async await
Agent state
Update simply
Task vs GenServer vs Agent

Task.async await

A Task runs one function in the background while the caller keeps working. The async call returns a task struct at once, and await blocks until the result arrives. This pair fits single computations whose answer the caller needs later.

task = Task.async(fn -> Enum.sum([1, 2, 3]) end) IO.inspect(Task.await(task))

6

Agent state

An Agent is a tiny process wrapping one value with get and update helpers. The start_link call boots it with the function return as the initial state. Reading never touches the value directly: a function receives the state and returns the part to expose.

{:ok, agent} = Agent.start_link(fn -> 0 end) IO.inspect(Agent.get(agent, fn n -> n end))

0

Update simply

The update call transforms the stored value with a function and returns the atom ok. Each update runs inside the agent, so concurrent callers cannot interleave and lose changes. Reading back afterwards shows the new value.

Agent.update(agent, fn n -> n + 1 end) IO.inspect(Agent.get(agent, fn n -> n end))

1

Task vs GenServer vs Agent

Pick the smallest tool that fits the job. Tasks handle one finished computation with a clear result. Agents guard plain shared state behind two functions. GenServers model long lived servers with custom messages and richer lifecycles.

# one finished job: Task # shared counter: Agent # custom messages and state: GenServer

Next: OTP applications

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: