Протокол инспекции protocol

Протокол Inspect отвечает за преобразование любых структур данных Elixir в документ алгебры. Затем этот документ форматируется, либо в формате красивой печати, либо в обычном.

Функция inspect/2 получает сущность, подлежащую инспекции, а затем параметры инспекции, представленные структурой Inspect.Opts.

Инспекция выполняется с помощью функций, доступных в Inspect.Algebra.

Примеры

Часто инспекция структуры может быть реализована в зависимости от существующих сущностей. Например, вот реализация MapSet’s inspect:

defimpl Inspect, for: MapSet do
  import Inspect.Algebra

  def inspect(dict, opts) do
    concat ["#MapSet<", to_doc(MapSet.to_list(dict), opts), ">"]
  end
end

Функция concat из Inspect.Algebra объединяет документы алгебры вместе. В примере выше она объединяет строку "MapSet<" (все строки являются допустимыми документами алгебры, которые сохраняют свой формат при красивой печати), документ, возвращаемый Inspect.Algebra.to_doc/2, и другую строку ">".

Поскольку обычные строки являются допустимыми сущностями в документе алгебры, реализация inspect может просто вернуть строку, хотя это лишит её любой возможности красивой печати.

Обработка ошибок

В случае возникновения ошибки во время инспекции структуры Elixir сгенерирует ошибку ArgumentError и автоматически перейдёт к представлению исходного формата для вывода структуры.

Однако вы можете получить доступ к основной ошибке, вызвав реализацию Inspect напрямую. Например, чтобы протестировать Inspect.MapSet выше, вы можете вызвать её так:

Inspect.MapSet.inspect(MapSet.new, %Inspect.Opts{})

Резюме

Типы

t()

Функции

inspect(term, opts)

Типы

t()

t() :: term

Функции

inspect(term, opts)