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

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

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

Требования:

  • Elixir - Версия 1.4.0 и выше
  • Erlang - Version 18.0 и выше

Приступим!

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

Установка

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

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

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

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

Откройте 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, чтобы сосредоточиться на коде. Для выхода из iex нажмите Ctrl+C дважды.

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

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

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

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

IO.puts "Hello world from Elixir"

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

$ elixir simple.exs
Hello world from Elixir

Позже мы научимся компилировать этот код (в Главе 8) и использовать инструмент сборки Mix (в Руководстве по Mix и OTP). Теперь можно двигаться дальше.

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

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

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

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

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

© 2017 / Россия Любые мысли и вопросы пишите на elixir@wunsh.ru.