Estructuras de control

if y unless

Es probable que hayas visto if/2 antes, y si has utilizado Ruby estás familiarizado con unless/2. En Elixir ambos funcionan de la misma forma pero están definidos como macros, no son construcciones propias del lenguaje; puedes encontrar su implementación en el módulo Kernel.

Debería tenerse en cuenta que en Elixir, los únicos valores falsos son nil y el booleano false.

iex> if String.valid?("Hello") do
...>   "Valid string!"
...> else
...>   "Invalid string."
...> end
"Valid string!"

iex> if "a string value" do
...>   "Truthy"
...> end
"Truthy"

Usar unless/2 es como if/2 solo que trabaja en forma inversa:

iex> unless is_integer("hello") do
...>   "Not an Int"
...> end
"Not an Int"

case

Si es necesario buscar una coincidencia en múltiples patrones podemos usar case:

iex> case {:ok, "Hello World"} do
...>   {:ok, result} -> result
...>   {:error} -> "Uh oh!"
...>   _ -> "Catch all"
...> end
"Hello World"

La variable _ es una inclusión importante en la declaración case. Sin esto, cuando no se encuentre una coincidencia, se lanzará un error:

iex> case :even do
...>   :odd -> "Odd"
...> end
** (CaseClauseError) no case clause matching: :even

iex> case :even do
...>   :odd -> "Odd"
...>   _ -> "Not Odd"
...> end
"Not Odd"

Considera _ como el else que coincidirá con “todo lo demás”. Ya que case se basa en la coincidencia de patrones, se aplican las mismas reglas y restricciones. Si intentas coincidir con variables existentes debes usar el operador pin ^:

iex> pie = 3.14
 3.14
iex> case "cherry pie" do
...>   ^pie -> "Not so tasty"
...>   pie -> "I bet #{pie} is tasty"
...> end
"I bet cherry pie is tasty"

Otra característica interesante de case es que soporta cláusulas de guardia:

Este ejemplo proviene directamente de la guía oficial de Elixir Getting Started.

iex> case {1, 2, 3} do
...>   {1, x, 3} when x > 0 ->
...>     "Will match"
...>   _ ->
...>     "Won't match"
...> end
"Will match"

Revisa la documentación oficial para Expresiones permitidas en cláusulas de guardia.

cond

Cuando necesitamos coincidencias con condiciones, y no valores, podemos cambiar a cond; esto es parecido a else if o elsif en otros lenguajes:

Este ejemplo proviene directamente de la guía oficial de Elixir Getting Started.

iex> cond do
...>   2 + 2 == 5 ->
...>     "This will not be true"
...>   2 * 2 == 3 ->
...>     "Nor this"
...>   1 + 1 == 2 ->
...>     "But this will"
...> end
"But this will"

Como case, cond lanzará un error si no hay una coincidencia. Para manejar esto, podemos definir una condición cuyo valor es true:

iex> cond do
...>   7 + 1 == 0 -> "Incorrect"
...>   true -> "Catch all"
...> end
"Catch all"

with

La forma especial with/1 es útil cuando se pueda usar un case/2 anidado o en situaciones que no puedan ser encadenadas limpiamente. La expresión with/1 está compuesta de palabras clave, generadores y, finalmente una expresión.

Hablaremos más de los generadores en la lección de completado de listas, pero por ahora lo que necesitamos saber es que usan coincidencia de patrones para comparar el lado derecho del <- con el izquierdo.

Empezaremos con un ejemplo simple de with/1 y después veremos algo más:

iex> user = %{first: "Sean", last: "Callan"}
%{first: "Sean", last: "Callan"}
iex> with {:ok, first} <- Map.fetch(user, :first),
...>      {:ok, last} <- Map.fetch(user, :last),
...>      do: last <> ", " <> first
"Callan, Sean"

En caso de que una expresión falle en coincidir, el valor que no coincida será devuelto:

iex> user = %{first: "doomspork"}
%{first: "doomspork"}
iex> with {:ok, first} <- Map.fetch(user, :first),
...>      {:ok, last} <- Map.fetch(user, :last),
...>      do: last <> ", " <> first
:error

Ahora veamos un ejemplo más grande sin with/1 y después veamos como lo podemos refactorizar:

case Repo.insert(changeset) do
  {:ok, user} ->
    case Guardian.encode_and_sign(user, :token, claims) do
      {:ok, token, full_claims} ->
        important_stuff(token, full_claims)

      error ->
        error
    end

  error ->
    error
end

Cuando introducimos with/1 terminamos con código que es más fácil de entender y es más corto:

with {:ok, user} <- Repo.insert(changeset),
     {:ok, token, full_claims} <- Guardian.encode_and_sign(user, :token, claims) do
  important_stuff(token, full_claims)
end

A partir Elixir 1.3 las sentencias with/1 soportan else:

import Integer

m = %{a: 1, c: 3}

a =
  with {:ok, number} <- Map.fetch(m, :a),
    true <- is_even(number) do
      IO.puts "#{number} divided by 2 is #{div(number, 2)}"
      :even
  else
    :error ->
      IO.puts("We don't have this item in map")
      :error

    _ ->
      IO.puts("It is odd")
      :odd
  end

Esto ayuda a manejar errores dándonos coincidencia de patrones parecida a la del case. El valor pasado es el de la primera expresión que no coincidió con el valor esperado.

¿Encontraste un error o quieres contribuir a la lección? ¡Edita esta lección en GitHub!