千层面

基础

变量

Elixir 是一门动态类型语言，这意味着变量的类型只在运行时检查。使用匹配运算符 =，我们可以把任意类型的值绑定到变量名上：

# Bound an integer value of 1
count = 1
# You may re-bind variables
count = 2

# You may re-bind any type to a variable
count = false

# Strings can be created by enclosing characters within double quotes
message = "Success!"

模块

Elixir 是一门函数式编程语言，它要求所有具名函数都定义在_模块_中。defmodule 关键字用来定义模块。所有模块在运行时都对其他模块可用，不需要_访问修饰符_就能让程序的其他部分看到它们。模块_类似于其他编程语言中的_类。

defmodule Calculator do
  # ...
end

具名函数

_具名函数_必须定义在模块中。def 关键字用来定义_公开_的具名函数。

每个函数可以有零个或多个实参。函数中最后一个表达式的值总是被_隐式返回_。

defmodule Calculator do
  def add(x, y) do
    x + y
  end
end

调用函数时，要指定它的模块名和函数名，并为函数的每个实参传入值。

sum = Calculator.add(1, 2)
# => 3

defp 关键字可以代替 def 来定义_私有_函数。私有函数只能在定义它们的同一个模块内部使用。

调用同一个模块中定义的函数时，可以省略模块名。

你也可以用单行语法编写简短的函数（注意关键字 do 前后的逗号 , 和冒号 :）。

defmodule Calculator do
  def subtract(x, y) do
    private_subtract(x, y)
  end

  defp private_subtract(x, y), do: x - y
end

difference = Calculator.subtract(7, 2)
# => 5

difference = Calculator.private_subtract(7, 2)
# => ** (UndefinedFunctionError) function Calculator.private_subtract/2 is undefined or private
#       Calculator.private_subtract(7, 2)

函数的元数

人们常用元数来指代函数。一个函数的元数是它接受的实参个数。

# add/3 because this function has three arguments, thus an arity of 3
def add(x, y, z) do
  x + y + z
end

命名约定

模块名应使用 PascalCase。模块名必须以大写字母 A-Z 开头，可以包含字母 a-zA-Z、数字 0-9 和下划线 _。

变量名和函数名应使用 snake_case。变量名或函数名必须以小写字母 a-z 或下划线 _ 开头，可以包含字母 a-zA-Z、数字 0-9 和下划线 _，并且可以以问号 ? 或感叹号 ! 结尾。

标准库

Elixir 拥有非常丰富、文档完善的标准库。文档可以在网上找到：hexdocs.pm/elixir。把这个链接收藏起来，你会经常用到它！

大多数内置数据类型都有对应的模块，提供处理该数据类型的函数，例如整数有 Integer 模块，字符串有 String 模块，数组有 List 模块，等等。

有一个值得注意的模块是 Kernel 模块。它提供了构建标准库其余部分所依赖的基础能力，比如算术运算符、控制流宏，等等。Kernel 模块中的函数会被自动导入，因此你无需加 Kernel. 前缀就能使用它们。

代码注释

注释可以用来给阅读源代码的其他开发者留言。Elixir 中的单行注释以 # 开头。