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

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

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

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

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

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

Сводка

Типы

t()

Функции

inspect(term, opts)

Типы

t()

t() :: term()

Функции

inspect(term, opts)