Список меток ListLabels

Псевдоним для типа списков.

Возвращает длину (количество элементов) данного списка.

Сравнивает длины двух списков. compare_lengths l1 l2 эквивалентно compare (length l1) (length l2), за исключением того, что вычисление останавливается после достижения конца самого короткого списка.

Сравнивает длину списка с целым числом. compare_length_with l len эквивалентно compare (length l) len, за исключением того, что вычисление останавливается после максимум len итераций по списку.

is_empty l истинно тогда и только тогда, когда l не имеет элементов. Эквивалентно compare_length_with l 0 = 0.

cons x xs равно x :: xs

Возвращает первый элемент данного списка.

Возвращает данный список без его первого элемента.

Возвращает n-ый элемент данного списка. Первый элемент (начало списка) находится на позиции 0.

Возвращает n-ый элемент данного списка. Первый элемент (начало списка) находится на позиции 0. Возвращает None если список слишком короткий.

Инвертирование списка.

init ~len ~f это [f 0; f 1; ...; f (len-1)], вычисляется слева направо.

append l0 l1 добавляет l1 к l0 . Такая же функция, как инфиксный оператор @.

rev_append l1 l2 инвертирует l1 и конкатенирует его с l2. Это эквивалентно (ListLabels.rev l1) @ l2.

Конкатенация списка списков. Элементы аргумента конкатенируются вместе (в том же порядке), чтобы получить результат. Не хвостовая рекурсия (длина аргумента + длина самого длинного подсписка).

То же, что ListLabels.concat. Не хвостовая рекурсия (длина аргумента + длина самого длинного подсписка).

equal eq [a1; ...; an] [b1; ..; bm] выполняется, когда два входных списка имеют одинаковую длину, и для каждой пары элементов ai, bi на той же позиции у нас есть eq ai bi.

Примечание: функция eq может вызываться даже если списки имеют разную длину. Если вы знаете, что функция равенства является дорогостоящей, вы можете сначала проверить ListLabels.compare_lengths.

compare cmp [a1; ...; an] [b1; ...; bm] выполняет лексикографическое сравнение двух входных списков, используя тот же интерфейс 'a -> 'a -> int как compare:

• a1 :: l1 меньше чем a2 :: l2 (отрицательный результат), если a1 меньше чем a2, или если они равны (результат 0) и l1 меньше чем l2
• пустой список [] строго меньше, чем непустые списки

Примечание: функция cmp будет вызвана, даже если списки имеют разную длину.

iter ~f [a1; ...; an] применяет функцию f поочередно к [a1; ...; an] . Эквивалентно f a1; f a2; ...; f an.

То же, что ListLabels.iter, но функция применяется к индексу элемента как первому аргументу (считая с 0), а сам элемент - как второму аргументу.

map ~f [a1; ...; an] применяет функцию f к a1, ..., an, и строит список [f a1; ...; f an] с результатами, возвращаемыми f.

То же, что ListLabels.map, но функция применяется к индексу элемента как первому аргументу (считая с 0), а сам элемент - как второму аргументу.

rev_map ~f l даёт тот же результат, что ListLabels.rev (ListLabels.map f l), но более эффективно.

filter_map ~f l применяет f к каждому элементу l, фильтрует None элементы и возвращает список аргументов Some элементов.

concat_map ~f l даёт тот же результат, что ListLabels.concat (ListLabels.map f l). Хвостовая рекурсия.

fold_left_map - это комбинация fold_left и map , которая проталкивает аккумулятора через вызовы f.

fold_left ~f ~init [b1; ...; bn] это f (... (f (f init b1) b2) ...) bn.

fold_right ~f [a1; ...; an] ~init это f a1 (f a2 (... (f an init) ...)). Не хвостовая рекурсия.

iter2 ~f [a1; ...; an] [b1; ...; bn] вызывает поочерёдно f a1 b1; ...; f an bn.

map2 ~f [a1; ...; an] [b1; ...; bn] это [f a1 b1; ...; f an bn].

rev_map2 ~f l1 l2 даёт тот же результат, что ListLabels.rev (ListLabels.map2 f l1 l2), но более эффективно.

fold_left2 ~f ~init [a1; ...; an] [b1; ...; bn] это f (... (f (f init a1 b1) a2 b2) ...) an bn.

fold_right2 ~f [a1; ...; an] [b1; ...; bn] ~init это f a1 b1 (f a2 b2 (... (f an bn init) ...)).

for_all ~f [a1; ...; an] проверяет, удовлетворяют ли все элементы списка предикату f. То есть, он возвращает (f a1) && (f a2) && ... && (f an) для непустого списка и true если список пустой.

exists ~f [a1; ...; an] проверяет, удовлетворяет ли хотя бы один элемент списка предикату f. То есть, он возвращает (f a1) || (f a2) || ... || (f an) для непустого списка и false если список пустой.

Аналогично ListLabels.for_all, но для предиката с двумя аргументами.

Аналогично ListLabels.exists, но для предиката с двумя аргументами.

mem a ~set истинно тогда и только тогда, когда a равно элементу set.

Аналогично ListLabels.mem, но использует физическое равенство вместо структурного равенства для сравнения элементов списка.

find ~f l возвращает первый элемент списка l , который удовлетворяет предикату f.

find ~f l возвращает первый элемент списка l , который удовлетворяет предикату f. Возвращает None если нет значения, удовлетворяющего f в списке l.

find_index ~f xs возвращает Some i, где i — индекс первого элемента списка xs , удовлетворяющего f x, если такой элемент существует.

Возвращает None если такого элемента нет.

find_map ~f l применяет f к элементам l по порядку и возвращает первый результат вида Some v, или None если таковых нет.

Аналогично find_map, но предикат применяется к индексу элемента как первому аргументу (считая с 0), а к самому элементу как второму аргументу.

filter ~f l возвращает все элементы списка l , удовлетворяющие предикату f. Порядок элементов в исходном списке сохраняется.

find_all — другое имя для ListLabels.filter.

Аналогично ListLabels.filter, но предикат применяется к индексу элемента как первому аргументу (считая с 0), а к самому элементу как второму аргументу.

partition ~f l возвращает пару списков (l1, l2), где l1 — список всех элементов l , удовлетворяющих предикату f, а l2 — список всех элементов l , не удовлетворяющих f. Порядок элементов в исходном списке сохраняется.

partition_map f l возвращает пару списков (l1, l2) так, что для каждого элемента x входного списка l:

• если f x является Left y1, то y1 находится в l1, и
• если f x является Right y2, то y2 находится в l2.

Выходные элементы включаются в l1 и l2 в том же относительном порядке, что и соответствующие входные элементы в l.

В частности, partition_map (fun x -> if f x then Left x else Right x) l эквивалентно partition f l.

assoc a l возвращает значение, связанное с ключом a в списке пар l. То есть, assoc a [ ...; (a,b); ...] = b если (a,b) — это самое левое связывание a в списке l.

assoc_opt a l возвращает значение, связанное с ключом a в списке пар l. То есть, assoc_opt a [ ...; (a,b); ...] = Some b если (a,b) — это самое левое связывание a в списке l. Возвращает None если нет значения, связанного с a в списке l.

Аналогично ListLabels.assoc, но использует физическое равенство вместо структурного равенства для сравнения ключей.

Аналогично ListLabels.assoc_opt, но использует физическое равенство вместо структурного равенства для сравнения ключей.

Аналогично ListLabels.assoc, но просто возвращает true если связывание существует, и false если нет связываний для данного ключа.

Аналогично ListLabels.mem_assoc, но использует физическое равенство вместо структурного равенства для сравнения ключей.

remove_assoc a l возвращает список пар l без первой пары с ключом a, если таковая есть. Не рекурсивно.

Аналогично ListLabels.remove_assoc, но использует физическое равенство вместо структурного равенства для сравнения ключей. Не рекурсивно.

Преобразование списка пар в пару списков: split [(a1,b1); ...; (an,bn)] — это ([a1; ...; an], [b1; ...; bn]). Не рекурсивно.

Преобразование пары списков в список пар: combine [a1; ...; an] [b1; ...; bn] — это [(a1,b1); ...; (an,bn)].

Сортировка списка по возрастанию согласно функции сравнения. Функция сравнения должна возвращать 0, если её аргументы равны, положительное целое число, если первый больше, и отрицательное целое число, если первый меньше (см. Array.sort для полной спецификации). Например, compare — подходящая функция сравнения. Результирующий список отсортирован по возрастанию. ListLabels.sort гарантированно работает в постоянном объёме памяти (в дополнение к размеру результата списка) и логарифмическом объёме стека.

Текущая реализация использует сортировку слиянием. Она работает в постоянном объёме памяти и логарифмическом объёме стека.

Аналогично ListLabels.sort, но алгоритм сортировки гарантированно устойчив (т.е. элементы, которые сравниваются как равные, сохраняются в их исходном порядке).

Текущая реализация использует сортировку слиянием. Она работает в постоянном объёме памяти и логарифмическом объёме стека.

Аналогично ListLabels.sort или ListLabels.stable_sort, какой из них быстрее на типичных данных.

Аналогично ListLabels.sort, но также удаляет дубликаты.

Объединение двух списков: Предполагая, что l1 и l2 отсортированы согласно функции сравнения cmp, merge ~cmp l1 l2 вернёт отсортированный список, содержащий все элементы l1 и l2. Если несколько элементов сравниваются как равные, элементы l1 будут перед элементами l2. Не рекурсивно (сумма длин аргументов).

Итерировать по списку.

Создать список из последовательности.