Inspect.Opts
Определяет параметры, используемые протоколом Inspect.
Доступны следующие поля:
-
:structs- когдаfalse, структуры не форматируются протоколом inspect, а вместо этого выводятся как карты, по умолчаниюtrue. -
:binaries- когда:as_stringsвсе двоичные данные будут выводиться как строки, непечатаемые байты будут экранированы.Когда
:as_binariesвсе двоичные данные будут выводиться в битовой нотации.По умолчанию
:infer, двоичные данные будут выводиться как строка, если они печатаемые, в противном случае в битовой нотации. См.String.printable?/1, чтобы узнать, когда строка печатаемая. -
:charlists- когда:as_charlistsвсе списки будут выводиться как списки символов, непечатаемые элементы будут экранированы.Когда
:as_listsвсе списки будут выводиться как списки.По умолчанию
:infer, список будет выводиться как список символов, если он печатаемый, в противном случае как список. См.List.ascii_printable?/1, чтобы узнать, когда список символов печатаемый. -
:limit- ограничивает количество элементов, которые проверяются для кортежей, битовых строк, карт, списков и любых других коллекций элементов. Он не применяется к печатаемым строкам и печатаемым спискам символов и по умолчанию равен 50. Если вы не хотите ограничивать количество элементов определённым числом, используйте:infinity. -
:printable_limit- ограничивает количество символов, которые проверяются в печатаемых строках и печатаемых списках символов. Вы можете использоватьString.printable?/1иList.ascii_printable?/1для проверки того, является ли данная строка или список символов печатаемым. По умолчанию 4096. Если вы не хотите ограничивать количество символов определённым числом, используйте:infinity. -
:pretty- если установленоtrue, включает красивое форматирование, по умолчаниюfalse. -
:width- по умолчанию 80 символов, используется при красивом форматировании или при выводе на устройства ввода-вывода. Установите значение 0, чтобы каждый элемент выводился на отдельной строке. Если вы не хотите ограничивать количество элементов определённым числом, используйте:infinity. -
:base- выводит целые числа как:binary,:octal,:decimal, или:hex, по умолчанию:decimal. При проверке двоичных данных любой:baseкроме:decimalподразумеваетbinaries: :as_binaries. -
:safe- когдаfalse, ошибки при проверке структур будут подняты как ошибки вместо того, чтобы быть обернутыми в исключениеInspect.Error. Это полезно при отладке ошибок и сбоев для пользовательских реализаций inspect. -
:syntax_colors- при установке в список ключевых слов цветов вывод будет цветным. Ключи — типы, значения — цвета для каждого типа (например,[number: :red, atom: :blue]). Типы могут включать:number,:atom,regex,:tuple,:map,:list, и:reset. Цвета могут быть любымиIO.ANSI.ansidata/0, которые принимаютсяIO.ANSI.format/1. -
:inspect_fun(с версии v1.9.0) - функция для построения документов алгебры, по умолчаниюInspect.inspect/2 -
:custom_options(с версии v1.9.0) - список ключевых слов, хранящий пользовательские параметры. Полезно при реализации протоколаInspectдля вложенных структур, чтобы передать пользовательские параметры.
Краткое описание
Типы
Типы
color_key()
Спецификации
color_key() :: atom()
t()
Спецификации
t() :: %Inspect.Opts{
base: :decimal | :binary | :hex | :octal,
binaries: :infer | :as_binaries | :as_strings,
char_lists: :infer | :as_lists | :as_char_lists,
charlists: :infer | :as_lists | :as_charlists,
custom_options: keyword(),
inspect_fun: (any(), t() -> Inspect.Algebra.t()),
limit: pos_integer() | :infinity,
pretty: boolean(),
printable_limit: pos_integer() | :infinity,
safe: boolean(),
structs: boolean(),
syntax_colors: [{color_key(), IO.ANSI.ansidata()}],
width: pos_integer() | :infinity
}
© 2012 Plataformatec
Licensed under the Apache License, Version 2.0.
https://hexdocs.pm/elixir/1.9.4/Inspect.Opts.html