Список

Связанные списки хранят ноль, один или более элементов в выбранном порядке.

Списки в Elixir определяются в квадратных скобках:

iex> [1, "two", 3, :four]
[1, "two", 3, :four]

Два списка могут быть конкатенированы и вычтены с помощью операторов Kernel.++/2 и Kernel.--/2:

iex> [1, 2, 3] ++ [4, 5, 6]
[1, 2, 3, 4, 5, 6]
iex> [1, true, 2, false, 3, true] -- [true, false]
[1, 2, 3, true]

Элемент может быть добавлен в начало списка с помощью |:

iex> new = 0
iex> list = [1, 2, 3]
iex> [new | list]
[0, 1, 2, 3]

Списки в Elixir фактически являются связанными списками, что означает, что они внутренне представлены парами, содержащими голову и хвост списка:

iex> [head | tail] = [1, 2, 3]
iex> head
1
iex> tail
[2, 3]

Аналогично, мы могли бы записать список [1, 2, 3], используя только такие пары (называемые ячейками cons):

iex> [1 | [2 | [3 | []]]]
[1, 2, 3]

Некоторые списки, называемые несобственными списками, не имеют пустого списка в качестве второго элемента в последней ячейке cons:

iex> [1 | [2 | [3 | 4]]]
[1, 2, 3 | 4]

Хотя несобственные списки обычно избегаются, они используются в некоторых особых случаях, таких как сущности iodata и chardata (см. модуль IO).

Благодаря представлению на основе ячеек cons, добавление элемента в начало списка всегда быстро (постоянное время), в то время как добавление в конец становится медленнее по мере увеличения размера списка (линейное время):

iex> list = [1, 2, 3]
iex> [0 | list] # fast
[0, 1, 2, 3]
iex> list ++ [4] # slow
[1, 2, 3, 4]

Большинство функций в этом модуле работают за линейное время. Это означает, что время, затрачиваемое на выполнение операции, растет с той же скоростью, что и длина списка. Например, length/1 и last/1 будут выполняться за линейное время, так как им нужно проитерироваться по каждому элементу списка, но first/1 будет выполняться за постоянное время, так как ему нужен только первый элемент.

Списки также реализуют протокол Enumerable, поэтому многие функции для работы со списками находятся в модуле Enum. Кроме того, следующие функции и операторы для списков находятся в Kernel:

Списки символов

Если список состоит из целых чисел без знака, где каждое целое число представляет код Юникода, список также может называться списком символов. Эти целые числа должны:

быть в диапазоне 0..0x10FFFF (0..1_114_111);
и быть вне диапазона 0xD800..0xDFFF (55_296..57_343), который зарезервирован в Юникоде для пар суррогатов UTF-16.

Elixir использует одинарные кавычки для определения списков символов:

iex> 'héllo'
[104, 233, 108, 108, 111]

В частности, списки символов будут выводиться по умолчанию в одинарных кавычках, если они содержат только печатаемые символы ASCII:

iex> 'abc'
'abc'

Несмотря на то, что представление изменилось, исходные данные остаются списком чисел, которые могут обрабатываться как таковые:

iex> inspect('abc', charlists: :as_list)
"[97, 98, 99]"
iex> Enum.map('abc', fn num -> 1000 + num end)
[1097, 1098, 1099]

Вы можете использовать помощник IEx.Helpers.i/1, чтобы получить краткое описание списков символов в IEx при их появлении, которое покажет вам тип, описание и также исходное представление в одном резюме.

Основанием для такого поведения является лучшая поддержка библиотек Erlang, которые могут возвращать текст в виде списков символов вместо строк Elixir. В Erlang списки символов являются стандартным способом обработки строк, а в Elixir — это двоичные данные. Одним из примеров таких функций является Application.loaded_applications/0:

Application.loaded_applications()
#=>  [
#=>    {:stdlib, 'ERTS  CXC 138 10', '2.6'},
#=>    {:compiler, 'ERTS  CXC 138 10', '6.0.1'},
#=>    {:elixir, 'elixir', '1.0.0'},
#=>    {:kernel, 'ERTS  CXC 138 10', '4.1'},
#=>    {:logger, 'logger', '1.0.0'}
#=>  ]

Можно проверить, состоит ли список только из печатаемых символов ASCII, с помощью ascii_printable?/2.

Несобственные списки никогда не считаются списками символов.

END_OF_DOCUMENT_MARKER

Краткое описание

Функции

ascii_printable?(list, limit \\ :infinity): Проверяет, является ли list списком символов, состоящих только из печатаемых ASCII-символов.
delete(list, element): Удаляет заданный element из list. Возвращает новый список без элемента.
delete_at(list, index): Создает новый список, удалив значение по указанному index.
duplicate(elem, n): Дублирует заданный элемент n раз в списке.
first(list, default \\ nil): Возвращает первый элемент в list или default, если list пустой.
flatten(list): Разворачивает данный list вложенных списков.
flatten(list, tail): Разворачивает данный list вложенных списков. Список tail будет добавлен в конец развернутого списка.
foldl(list, acc, fun): Складывает (сокращает) данный список слева с помощью функции. Требуется накопитель, который может быть любым значением.
foldr(list, acc, fun): Складывает (сокращает) данный список справа с помощью функции. Требуется накопитель, который может быть любым значением.
improper?(list): Возвращает true, если list является неправильным списком. В противном случае возвращает false.
insert_at(list, index, value): Возвращает список с value, вставленным по указанному index.
keydelete(list, key, position): Принимает list кортежей и удаляет первый кортеж, где элемент в position соответствует заданному key. Возвращает новый список.
keyfind!(list, key, position): Принимает список кортежей и возвращает первый кортеж, где элемент в position в кортеже соответствует заданному key.
keyfind(list, key, position, default \\ nil): Принимает список кортежей и возвращает первый кортеж, где элемент в position в кортеже соответствует заданному key.
keymember?(list, key, position): Принимает список кортежей и возвращает true, если существует кортеж, где элемент в position в кортеже соответствует заданному key.
keyreplace(list, key, position, new_tuple): Принимает список кортежей и, если идентифицированный элемент key в position существует, заменяет его на new_tuple.
keysort(list, position): Принимает список кортежей и сортирует элементы в position кортежей. Сортировка стабильна.
keystore(list, key, position, new_tuple): Принимает list кортежей и заменяет элемент, идентифицируемый key в position на new_tuple.
keytake(list, key, position): Принимает list кортежей и возвращает первый кортеж, где элемент в position в кортеже соответствует заданному key, а также list без найденного кортежа.
last(list, default \\ nil): Возвращает последний элемент в list или default, если list пустой.
myers_difference(list1, list2): Возвращает список ключевых слов, представляющий сценарий редактирования.
myers_difference(list1, list2, diff_script): Возвращает список ключевых слов, представляющий сценарий редактирования с вложенными различиями.
pop_at(list, index, default \\ nil): Возвращает и удаляет значение по указанному index в list.
replace_at(list, index, value): Возвращает список с изменённым значением по указанному index.
starts_with?(list, prefix): Возвращает true если list начинается с данного prefix списка; в противном случае возвращает false.
to_atom(charlist): Преобразует список символов в атом.
to_charlist(list): Преобразует список целых чисел, представляющих кодовые точки Юникода, списки или строки в список символов.
to_existing_atom(charlist): Преобразует список символов в существующий атом. Вызывает ArgumentError, если атом не существует.
to_float(charlist): Возвращает число с плавающей точкой, текстовое представление которого charlist.
to_integer(charlist): Возвращает целое число, текстовое представление которого charlist.
to_integer(charlist, base): Возвращает целое число, текстовое представление которого charlist в системе счисления base.
to_string(list): Преобразует список целых чисел, представляющих кодовые точки, списки или строки в строку.
to_tuple(list): Преобразует список в кортеж.
update_at(list, index, fun): Возвращает список с обновленным значением по указанному index.
wrap(term): Оборачивает term в список, если это не список.
zip(list_of_lists): Сшивает соответствующие элементы из каждого списка в list_of_lists.

END_OF_DOCUMENT_MARKER

Функции

ascii_printable?(list, limit \\ :infinity)Исходный код

@spec ascii_printable?(list(), 0) :: true

@spec ascii_printable?([], limit) :: true when limit: :infinity | pos_integer()

@spec ascii_printable?([...], limit) :: boolean()
when limit: :infinity | pos_integer()

Проверяет, является ли list списком символов, состоящим только из печатаемых символов ASCII.

Принимает необязательный limit в качестве второго аргумента. ascii_printable?/2 проверяет печатаемость списка только до limit.

Печатаемый список символов в Elixir содержит только печатаемые символы в стандартной семибитной кодировке ASCII, которые представляют собой символы, диапазон которых от 32 до 126 в десятичной нотации, плюс следующие управляющие символы:

?\a - Звонок
?\b - Возврат на один символ назад
?\t - Горизонтальная табуляция
?\n - Перевод строки
?\v - Вертикальная табуляция
?\f - Форма подачи
?\r - Возврат каретки
?\e - Экранирование

Дополнительную информацию можно найти в разделе Группы символов статьи Википедии о стандарте ASCII.

Примеры

iex> List.ascii_printable?('abc')
true

iex> List.ascii_printable?('abc' ++ [0])
false

iex> List.ascii_printable?('abc' ++ [0], 2)
true

Неправильные списки не являются печатаемыми, даже если состоят только из символов ASCII:

iex> List.ascii_printable?('abc' ++ ?d)
false

delete(list, element)Исходный код

@spec delete([], any()) :: []

@spec delete([...], any()) :: list()

Удаляет указанный element из list. Возвращает новый список без элемента.

Если element встречается более одного раза в list, удаляется только первое его вхождение.

Примеры

iex> List.delete([:a, :b, :c], :a)
[:b, :c]

iex> List.delete([:a, :b, :c], :d)
[:a, :b, :c]

iex> List.delete([:a, :b, :b, :c], :b)
[:a, :b, :c]

iex> List.delete([], :b)
[]

delete_at(list, index)Исходный код

@spec delete_at(list(), integer()) :: list()

Создаёт новый список, удаляя значение по указанному index.

Отрицательные индексы указывают смещение от конца list. Если index выходит за пределы, возвращается исходный list.

Примеры

iex> List.delete_at([1, 2, 3], 0)
[2, 3]

iex> List.delete_at([1, 2, 3], 10)
[1, 2, 3]

iex> List.delete_at([1, 2, 3], -1)
[1, 2]

duplicate(elem, n)Исходный код

@spec duplicate(any(), 0) :: []

@spec duplicate(elem, pos_integer()) :: [elem, ...] when elem: var

Дублирует данный элемент n раз в списке.

n — целое число, большее или равное 0.

Если n равно 0, возвращается пустой список.

Примеры

iex> List.duplicate("hello", 0)
[]

iex> List.duplicate("hi", 1)
["hi"]

iex> List.duplicate("bye", 2)
["bye", "bye"]

iex> List.duplicate([1, 2], 3)
[[1, 2], [1, 2], [1, 2]]

first(list, default \\ nil)Исходный код

@spec first([], any()) :: any()

@spec first([elem, ...], any()) :: elem when elem: var

Возвращает первый элемент в list или default, если list пуст.

first/2 был представлен в Elixir v1.12.0, а first/1 доступен с v1.0.0.

Примеры

iex> List.first([])
nil

iex> List.first([], 1)
1

iex> List.first([1])
1

iex> List.first([1, 2, 3])
1

flatten(list)Исходный код

@spec flatten(deep_list) :: list() when deep_list: [any() | deep_list]

Разглаживает данный list вложенных списков.

Элементы списка нулевой длины отбрасываются.

Примеры

iex> List.flatten([1, [[2], 3]])
[1, 2, 3]

iex> List.flatten([[], [[], []]])
[]

flatten(list, tail)Исходный код

@spec flatten(deep_list, [elem]) :: [elem]
when deep_list: [elem | deep_list], elem: var

Разглаживает данный list вложенных списков. Список tail будет добавлен в конец разглаженного списка.

Элементы списка нулевой длины из list отбрасываются, но не из tail.

Примеры

iex> List.flatten([1, [[2], 3]], [4, 5])
[1, 2, 3, 4, 5]

iex> List.flatten([1, [], 2], [3, [], 4])
[1, 2, 3, [], 4]

foldl(list, acc, fun)Исходный код

@spec foldl([elem], acc, (elem, acc -> acc)) :: acc when elem: var, acc: var

Складывает (сводит) данный список слева с помощью функции. Требует накопитель, который может быть любым значением.

Примеры

iex> List.foldl([5, 5], 10, fn x, acc -> x + acc end)
20

iex> List.foldl([1, 2, 3, 4], 0, fn x, acc -> x - acc end)
2

iex> List.foldl([1, 2, 3], {0, 0}, fn x, {a1, a2} -> {a1 + x, a2 - x} end)
{6, -6}

foldr(list, acc, fun)Исходный код

@spec foldr([elem], acc, (elem, acc -> acc)) :: acc when elem: var, acc: var

Складывает (сводит) данный список справа с помощью функции. Требует накопитель, который может быть любым значением.

Примеры

iex> List.foldr([1, 2, 3, 4], 0, fn x, acc -> x - acc end)
-2

iex> List.foldr([1, 2, 3, 4], %{sum: 0, product: 1}, fn x, %{sum: a1, product: a2} -> %{sum: a1 + x, product: a2 * x} end)
%{product: 24, sum: 10}

improper?(list)Исходный код

@spec improper?(maybe_improper_list()) :: boolean()

Возвращает true если list — неправильный список. В противном случае возвращает false.

Примеры

iex> List.improper?([1, 2 | 3])
true

iex> List.improper?([1, 2, 3])
false

insert_at(list, index, value)Исходный код

@spec insert_at(list(), integer(), any()) :: list()

Возвращает список с value, вставленным по указанному index.

Обратите внимание, что index ограничен длиной списка. Отрицательные индексы указывают смещение от конца list.

Примеры

iex> List.insert_at([1, 2, 3, 4], 2, 0)
[1, 2, 0, 3, 4]

iex> List.insert_at([1, 2, 3], 10, 0)
[1, 2, 3, 0]

iex> List.insert_at([1, 2, 3], -1, 0)
[1, 2, 3, 0]

iex> List.insert_at([1, 2, 3], -10, 0)
[0, 1, 2, 3]

keydelete(list, key, position)Исходный код

@spec keydelete([tuple()], any(), non_neg_integer()) :: [tuple()]

Получает list кортежей и удаляет первый кортеж, где элемент по position соответствует заданному key. Возвращает новый список.

Примеры

iex> List.keydelete([a: 1, b: 2], :a, 0)
[b: 2]

iex> List.keydelete([a: 1, b: 2], 2, 1)
[a: 1]

iex> List.keydelete([a: 1, b: 2], :c, 0)
[a: 1, b: 2]

keyfind!(list, key, position)Исходный код

@spec keyfind!([tuple()], any(), non_neg_integer()) :: any()

Получает список кортежей и возвращает первый кортеж, где элемент по position в кортеже соответствует заданному key.

Если подходящий кортеж не найден, генерируется ошибка.

Примеры

iex> List.keyfind!([a: 1, b: 2], :a, 0)
{:a, 1}

iex> List.keyfind!([a: 1, b: 2], 2, 1)
{:b, 2}

iex> List.keyfind!([a: 1, b: 2], :c, 0)
** (KeyError) key :c at position 0 not found in: [a: 1, b: 2]

keyfind(list, key, position, default \\ nil)Исходный код

@spec keyfind([tuple()], any(), non_neg_integer(), any()) :: any()

Если подходящий кортеж не найден, возвращается default.

Примеры

iex> List.keyfind([a: 1, b: 2], :a, 0)
{:a, 1}

iex> List.keyfind([a: 1, b: 2], 2, 1)
{:b, 2}

iex> List.keyfind([a: 1, b: 2], :c, 0)
nil

keymember?(list, key, position)Исходный код

@spec keymember?([tuple()], any(), non_neg_integer()) :: boolean()

Получает список кортежей и возвращает true если существует кортеж, где элемент по position в кортеже соответствует заданному key.

Примеры

iex> List.keymember?([a: 1, b: 2], :a, 0)
true

iex> List.keymember?([a: 1, b: 2], 2, 1)
true

iex> List.keymember?([a: 1, b: 2], :c, 0)
false

keyreplace(list, key, position, new_tuple)Исходный код

@spec keyreplace([tuple()], any(), non_neg_integer(), tuple()) :: [tuple()]

Получает список кортежей и, если идентифицированный элемент с помощью key по position существует, заменяет его на new_tuple.

Примеры

iex> List.keyreplace([a: 1, b: 2], :a, 0, {:a, 3})
[a: 3, b: 2]

iex> List.keyreplace([a: 1, b: 2], :a, 1, {:a, 3})
[a: 1, b: 2]

keysort(list, position)Исходный код

@spec keysort([tuple()], non_neg_integer()) :: [tuple()]

Получает список кортежей и сортирует элементы по position кортежей. Сортировка стабильная.

Примеры

iex> List.keysort([a: 5, b: 1, c: 3], 1)
[b: 1, c: 3, a: 5]

iex> List.keysort([a: 5, c: 1, b: 3], 0)
[a: 5, b: 3, c: 1]

END_OF_DOCUMENT_MARKER

keystore(list, key, position, new_tuple)Source

@spec keystore([tuple()], any(), non_neg_integer(), tuple()) :: [tuple(), ...]

Получает список кортежей и заменяет элемент, определённый по key в позиции position, на new_tuple.

Если элемент не существует, он добавляется в конец list.

Примеры

iex> List.keystore([a: 1, b: 2], :a, 0, {:a, 3})
[a: 3, b: 2]

iex> List.keystore([a: 1, b: 2], :c, 0, {:c, 3})
[a: 1, b: 2, c: 3]

keytake(list, key, position)Source

@spec keytake([tuple()], any(), non_neg_integer()) :: {tuple(), [tuple()]} | nil

Получает список кортежей и возвращает первый кортеж, где элемент в позиции position в кортеже соответствует заданному key, а также list без найденного кортежа.

Если такой кортеж не найден, возвращается nil.

Примеры

iex> List.keytake([a: 1, b: 2], :a, 0)
{{:a, 1}, [b: 2]}

iex> List.keytake([a: 1, b: 2], 2, 1)
{{:b, 2}, [a: 1]}

iex> List.keytake([a: 1, b: 2], :c, 0)
nil

last(list, default \\ nil)Source

@spec last([], any()) :: any()

@spec last([elem, ...], any()) :: elem when elem: var

Возвращает последний элемент в list или default, если list пустой.

last/2 был представлен в Elixir v1.12.0, в то время как last/1 доступен с v1.0.0.

Примеры

iex> List.last([])
nil

iex> List.last([], 1)
1

iex> List.last([1])
1

iex> List.last([1, 2, 3])
3

myers_difference(list1, list2)Source

@spec myers_difference(list(), list()) :: [{:eq | :ins | :del, list()}]

Возвращает список ключевых слов, представляющих сценарий редактирования.

Алгоритм описан в статье "An O(ND) Difference Algorithm and Its Variations" Э. Майерса.

Сценарий редактирования — это список ключевых слов. Каждый ключ описывает "действие редактирования", которое необходимо выполнить, чтобы приблизить list1 к равенству с list2; ключ может быть :eq, :ins, или :del. Каждое значение — это подсписок либо list1, либо list2, который необходимо вставить (если соответствующий ключ :ins), удалить (если соответствующий ключ :del) или оставить без изменений (если соответствующий ключ :eq) в list1 для приближения к list2.

См. myers_difference/3, если необходимо обрабатывать вложенные сценарии различий.

Примеры

iex> List.myers_difference([1, 4, 2, 3], [1, 2, 3, 4])
[eq: [1], del: [4], eq: [2, 3], ins: [4]]

myers_difference(list1, list2, diff_script)Source

@spec myers_difference(list(), list(), (term(), term() -> script | nil)) :: script
when script: [{:eq | :ins | :del | :diff, list()}]

Возвращает список ключевых слов, представляющих сценарий редактирования с вложенными различиями.

Это расширение myers_difference/2, где в случае необходимости вычисления вложенных различий можно указать функцию diff_script. Функция может вернуть список с внутренним сценарием редактирования или nil в случае отсутствия такого сценария. Возвращаемый внутренний сценарий редактирования будет находиться под ключом :diff.

Примеры

iex> List.myers_difference(["a", "db", "c"], ["a", "bc"], &String.myers_difference/2)
[eq: ["a"], diff: [del: "d", eq: "b", ins: "c"], del: ["c"]]

pop_at(list, index, default \\ nil)Source

@spec pop_at(list(), integer(), any()) :: {any(), list()}

Возвращает и удаляет значение по указанному index в list.

Отрицательные индексы указывают на смещение от конца list. Если index выходит за пределы, возвращается исходный list.

Примеры

iex> List.pop_at([1, 2, 3], 0)
{1, [2, 3]}
iex> List.pop_at([1, 2, 3], 5)
{nil, [1, 2, 3]}
iex> List.pop_at([1, 2, 3], 5, 10)
{10, [1, 2, 3]}
iex> List.pop_at([1, 2, 3], -1)
{3, [1, 2]}

replace_at(list, index, value)Source

@spec replace_at(list(), integer(), any()) :: list()

Возвращает список с заменённым значением по указанному index.

Примеры

iex> List.replace_at([1, 2, 3], 0, 0)
[0, 2, 3]

iex> List.replace_at([1, 2, 3], 10, 0)
[1, 2, 3]

iex> List.replace_at([1, 2, 3], -1, 0)
[1, 2, 0]

iex> List.replace_at([1, 2, 3], -10, 0)
[1, 2, 3]

starts_with?(list, prefix)Source

@spec starts_with?([...], [...]) :: boolean()

@spec starts_with?(list(), []) :: true

@spec starts_with?([], [...]) :: false

Возвращает true, если list начинается с данного prefix списка; в противном случае возвращает false.

Если prefix пустой список, возвращает true.

Примеры

iex> List.starts_with?([1, 2, 3], [1, 2])
true

iex> List.starts_with?([1, 2], [1, 2, 3])
false

iex> List.starts_with?([:alpha], [])
true

iex> List.starts_with?([], [:alpha])
false

to_atom(charlist)Source

@spec to_atom(charlist()) :: atom()

Преобразует список символов в атом.

Elixir поддерживает преобразования из списков символов, содержащих любые символы Юникода.

Встраивается компилятором.

Примеры

iex> List.to_atom('Elixir')
:Elixir

iex> List.to_atom('🌢 Elixir')
:"🌢 Elixir"

to_charlist(list)Source

@spec to_charlist(:unicode.charlist()) :: charlist()

Преобразует список целых чисел, представляющих символы Юникода, списки или строки в список символов.

Обратите внимание, что эта функция ожидает список целых чисел, представляющих символы Юникода. Если у вас есть список байтов, используйте вместо этого модуль :binary.

Примеры

iex> List.to_charlist([0x00E6, 0x00DF])
'æß'

iex> List.to_charlist([0x0061, "bc"])
'abc'

iex> List.to_charlist([0x0064, "ee", ['p']])
'deep'

to_existing_atom(charlist)Source

@spec to_existing_atom(charlist()) :: atom()

Преобразует список символов в существующий атом. Вызывает исключение ArgumentError, если атом не существует.

Elixir поддерживает преобразования из списков символов, содержащих любые символы Юникода.

Встраивается компилятором.

Примеры

iex> _ = :my_atom
iex> List.to_existing_atom('my_atom')
:my_atom

iex> _ = :"🌢 Elixir"
iex> List.to_existing_atom('🌢 Elixir')
:"🌢 Elixir"

to_float(charlist)Source

@spec to_float(charlist()) :: float()

Возвращает число с плавающей точкой, текстовое представление которого charlist.

Встраивается компилятором.

Примеры

iex> List.to_float('2.2017764e+0')
2.2017764

to_integer(charlist)Source

@spec to_integer(charlist()) :: integer()

Возвращает целое число, текстовое представление которого charlist.

Встраивается компилятором.

Примеры

iex> List.to_integer('123')
123

to_integer(charlist, base)Source

@spec to_integer(
  charlist(),
  2..36
) :: integer()

Возвращает целое число, текстовое представление которого charlist в системе счисления base.

Встраивается компилятором.

Основание должно быть в диапазоне от 2 до 36.

Примеры

iex> List.to_integer('3FF', 16)
1023

to_string(list)Source

@spec to_string(:unicode.charlist()) :: String.t()

Преобразует список целых чисел, представляющих символы Юникода, списки или строки в строку.

Для преобразования в строку список должен быть пустым или содержать только следующие элементы:

строки
целые числа, представляющие символы Юникода
список, содержащий один из этих трёх элементов

Примеры

iex> List.to_string([0x00E6, 0x00DF])
"æß"

iex> List.to_string([0x0061, "bc"])
"abc"

iex> List.to_string([0x0064, "ee", ['p']])
"deep"

iex> List.to_string([])
""

END_OF_DOCUMENT_MARKER

to_tuple(список)Source

@spec to_tuple(list()) :: tuple()

Преобразует список в кортеж.

Встраивается компилятором.

Примеры

iex> List.to_tuple([:share, [:elixir, 163]])
{:share, [:elixir, 163]}

update_at(список, индекс, функция)Source

@spec update_at([elem], integer(), (elem -> any())) :: list() when elem: var

Возвращает список с обновлённым значением по указанному index.

Примеры

iex> List.update_at([1, 2, 3], 0, &(&1 + 10))
[11, 2, 3]

iex> List.update_at([1, 2, 3], 10, &(&1 + 10))
[1, 2, 3]

iex> List.update_at([1, 2, 3], -1, &(&1 + 10))
[1, 2, 13]

iex> List.update_at([1, 2, 3], -10, &(&1 + 10))
[1, 2, 3]

wrap(элемент)Source

@spec wrap(term()) :: maybe_improper_list()

Оборачивает term в список, если это не список.

Если term уже является списком, возвращает список. Если term является nil, возвращает пустой список.

Примеры

iex> List.wrap("hello")
["hello"]

iex> List.wrap([1, 2, 3])
[1, 2, 3]

iex> List.wrap(nil)
[]

zip(список_списков)Source

@spec zip([list()]) :: [tuple()]

Объединяет соответствующие элементы из каждого списка в list_of_lists.

Объединение завершается, как только какой-либо список завершается.

Примеры

iex> List.zip([[1, 2], [3, 4], [5, 6]])
[{1, 3, 5}, {2, 4, 6}]

iex> List.zip([[1, 2], [3], [5, 6]])
[{1, 3, 5}]

Настройки Список

Списки символов

Краткое описание

Функции

Функции

ascii_printable?(list, limit \\ :infinity)Исходный код

Примеры

delete(list, element)Исходный код

Примеры

delete_at(list, index)Исходный код

Примеры

duplicate(elem, n)Исходный код

Примеры

first(list, default \\ nil)Исходный код

Примеры

flatten(list)Исходный код

Примеры

flatten(list, tail)Исходный код

Примеры

foldl(list, acc, fun)Исходный код

Примеры

foldr(list, acc, fun)Исходный код

Примеры

improper?(list)Исходный код

Примеры

insert_at(list, index, value)Исходный код

Примеры

keydelete(list, key, position)Исходный код

Примеры

keyfind!(list, key, position)Исходный код

Примеры

keyfind(list, key, position, default \\ nil)Исходный код

Примеры

keymember?(list, key, position)Исходный код

Примеры

keyreplace(list, key, position, new_tuple)Исходный код

Примеры

keysort(list, position)Исходный код

Примеры

keystore(list, key, position, new_tuple)Source

Примеры

keytake(list, key, position)Source

Примеры

last(list, default \\ nil)Source

Примеры

myers_difference(list1, list2)Source

Примеры

myers_difference(list1, list2, diff_script)Source

Примеры

pop_at(list, index, default \\ nil)Source

Примеры

replace_at(list, index, value)Source

Примеры

starts_with?(list, prefix)Source

Примеры

to_atom(charlist)Source

Примеры

to_charlist(list)Source

Примеры

to_existing_atom(charlist)Source

Примеры

to_float(charlist)Source

Примеры

to_integer(charlist)Source

Примеры

to_integer(charlist, base)Source

Примеры

to_string(list)Source

Примеры

to_tuple(список)Source

Примеры

update_at(список, индекс, функция)Source

Примеры

wrap(элемент)Source

Примеры

zip(список_списков)Source

Примеры

Список