什么是 Elixir Bang 功能？

Question

在阅读 Phoenix 教程（在 Incoming Events 部分）时，我首先注意到一个带有结尾感叹号/bang(!) 的函数

def handle_in("new_msg", %{"body" => body}, socket) do
    broadcast! socket, "new_msg", %{body: body}
    {:noreply, socket}
end

后面的感叹号是什么意思？它有什么作用吗？我一直在四处寻找并尝试寻找，但我不确定我使用的术语是否正确。到目前为止，似乎仅作为约定的函数在失败时会引发错误，但它总是意味着这样。

我看到的唯一提及它出现在 Dave Thomas 的“Programming Elixir”中：

Identifiers in Elixir are combinations of upper and lower case ASCII 
characters, digits, and underscores. Function names may end with a 
question mark or an exclamation point.

在the documentation 中也提到：

Notice that when the file does not exist, the version with ! raises an
error. The version without ! is preferred when you want to handle
different outcomes using pattern matching...

这些都没有解释这是否是其他长生不老药师或炼金术士或其他任何人使用的惯例。请帮忙。

Answer 1

这个：

请注意，当文件不存在时，带有 !提出一个 错误。没有的版本！当你想处理时是首选 使用模式匹配的不同结果...

如果你看一下源代码会更清楚。函数名中的! 符号只是一个语法协议。如果您看到一个函数的名称中包含 ! 符号，这意味着可能存在同名的函数，但没有 ! 符号。这两个函数会做同样的事情，但它们会以不同的方式处理错误。

没有! 的函数只会返回一个错误给你。您将需要知道一种错误并根据您的类型处理它。查看broadcast/3 函数（variant 没有!）：

  def broadcast(server, topic, message) when is_atom(server),
    do: call(server, :broadcast, [:none, topic, message])

它只是调用给定的服务器并返回它的结果。 broadcast!/3 函数会做同样的事情，但是：它将在没有 ! 的情况下调用 broadcast 函数，将检查其结果并引发 BroadcastError exception：

  def broadcast!(server, topic, message) do
    case broadcast(server, topic, message) do
      :ok -> :ok
      {:error, reason} -> raise BroadcastError, message: reason
    end
  end

Answer 2

这只是一个命名约定。检查这个答案 - What's the meaning of "!", "?", "_", and "." syntax in elixir

！ - 如果函数遇到错误，将引发异常。

一个很好的例子是 Enum.fetch！（它也有一个相同的 Enum.fetch 不会引发异常）。查找给定索引处的元素（从零开始）。如果给定位置超出集合范围，则引发 OutOfBoundsError。

Answer 3

你基本上是对的，Marc - 按照惯例，如果出现问题，请说 DO RAISE AN ERROR。

在page 上有一种文档，其中讨论了文件访问 （向下滚动到短语 trailing bang）