Документация Elixir

Добро пожаловать!

В этом руководстве мы научим вас основам Эликсира, синтаксису языка, расскажем, как объявлять модули, как управлять основными структурами данных и ещё некоторым вещам. Эта глава посвящена проверке установки Эликсира и запуску его интерактивной оболочки, которая называется IEx.

Требования:

• Эликсир (версии 1.4.0 и выше);
• Эрланг (версии 18.0 и выше).

Приступим!

Если вы нашли ошибку в этом руководстве, пожалуйста, сообщите о ней или пришлите исправление.

Установка

Если вы всё ещё не установили Эликсир, сделайте это с помощью инструкции по установке. Когда закончите, выполните команду elixir --version для получения текущей версии языка.

Интерактивный режим

Когда вы установите Эликсир, у вас будет три исполняемых команды: iex, elixir и elixirc. Если вы скомпилировали Эликсир из исходников или используете пакетную версию, вы сможете найти их в директории bin.

Начнём с выполнения команды iex (или iex.bat для Виндоус), которая отвечает за запуск интерактивной оболочки Эликсира. В этом режиме мы можем напечатать любое выражение на Эликсире и получить результат его выполнения. Опробуем несколько базовых команд для разогрева.

Откройте IEx командой iex и введите следующие выражения:

Erlang/OTP 19 [erts-8.1] [source] [64-bit] [smp:4:4] [async-threads:10] [hipe] [kernel-poll:false] [dtrace]
Interactive Elixir (1.4.0) – press Ctrl+C to exit (type h() ENTER for help)

iex(1)> 40 + 2
42

iex(2)> "hello" <> " world"
"hello world"

Учтите, что некоторые детали, такие как номера версий, могут немного отличаться, и сейчас это не так важно. Далее мы опустим служебный вывод IEx, чтобы сосредоточиться на коде. Для выхода из консоли нажмите Ctrl+C дважды.

Похоже, можно идти дальше!

Обратите внимание. Если у вас Виндоус, вы также можете попробовать выполнить команду iex.bat --werl для получения более удобного интерфейса, в зависимости от консоли, которую вы используете.

Запуск скриптов

После знакомства с основами языка можно попробовать написать простую программу. Это можно сделать, поместив следующий код на Эликсире в файл:

IO.puts "Hello world from Elixir"

Сохраните его как simple.exs и выполните командой elixir:

$ elixir simple.exs
Hello world from Elixir

Позже мы научимся компилировать этот код (в главе «Модули и функции») и использовать инструмент сборки Микс (во «Введении в Микс»). Теперь можно двигаться дальше.

Где можно задать вопрос?

По ходу чтения данного руководства у вас могут возникать вопросы, в конце концов, это часть процесса обучения! Вот несколько мест, где вы можете задать вопрос и узнать больше об Эликсире:

• Русскоязычный чат в Телеграме
• Канал #elixir-lang в IRC
• Эликсир в Слаке
• Форум по Эликсиру
• Тег elixir на StackOverflow

Чтобы с большей вероятностью получить ответ на ваш вопрос, используйте две подсказки:

• Вместо вопроса «как написать X на Эликсире», спросите «как на Эликсире решить задачу Y». Другими словами, не стоит спрашивать реализацию конкретного решения, вместо объяснения сути проблемы. Отталкивание от проблемы даст больше контекста для нахождения корректного ответа.

• В случае, если что-то работает не так, как ожидалось, пожалуйста, включите достаточно информации в свой отчёт. Например, вашу версию Эликсира, сниппет самого кода и сообщение об ошибке вместе с трассировкой стека. Используйте такие сайты, как Gist, для размещения подобной информации.