Files and IO

Contents
File.read
File.write
Stream lines
Path joins

File.read

The File.read function returns an ok tuple with the whole content or an error tuple with the reason. Matching both shapes with case keeps missing files from crashing the program. Small config files and notes fit this shape well.

File.write!("notes.txt", "hello\n") case File.read("notes.txt") do {:ok, data} -> IO.puts(data) {:error, _reason} -> IO.puts("missing") end

hello

File.write

The File.write function stores a binary under the given name and returns the atom ok on success. It replaces the whole file, so earlier content is lost. The bang twin raises instead of returning an error tuple.

IO.inspect(File.write("notes.txt", "hello\n"))

:ok

Stream lines

Reading the whole file breaks down on huge logs, so File.stream! opens a lazy enumerable of lines. Enum functions then pull only what they need while the rest stays on disk. Taking two lines never loads the whole file.

File.write!("notes.txt", "a\nb\nc\n") first_two = Enum.take(File.stream!("notes.txt"), 2) IO.inspect(first_two)

["a\n", "b\n"]

Path joins

String concatenation guesses separators and breaks across systems, so the Path module joins segments for you. Path.join inserts the right separator while expand resolves home and relative parts. Build every file path this way instead of gluing strings.

IO.puts(Path.join("notes", "a.txt"))

notes/a.txt

Next: Processes

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: