Список модулей

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

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

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

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

cons x xs является x :: xs

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

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

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

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

Обращение списка.

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

Конкатенация двух списков. Та же функция, что и инфиксный оператор @. Не является хвостовой рекурсией (длина первого аргумента). Оператор @ также не является хвостовой рекурсией.

rev_append l1 l2 инвертирует l1 и конкатенирует его с l2. Это эквивалентно (List.rev l1) @ l2, но rev_append является хвостовой рекурсией и более эффективной.

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

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

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

Примечание: функция eq может быть вызвана даже если списки имеют разную длину. Если вы знаете, что ваша функция равенства дорогостоящая, вы можете сначала проверить List.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.

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

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

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

rev_map f l дает тот же результат, что и List.rev (List.map f l), но является хвостовой рекурсией и более эффективной.

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

concat_map f l дает тот же результат, что и List.concat (List.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 дает тот же результат, что и List.rev (List.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 если список пуст.

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

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

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

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

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

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

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

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

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

Аналогично List.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 если в списке l нет значения, связанного с a.

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

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

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

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

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

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

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

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

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

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

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

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

Аналогично List.sort или List.stable_sort, то из них, что быстрее на типичном входе.

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

Слияние двух списков: Предполагая, что l1 и l2 отсортированы в соответствии с функцией сравнения cmp, merge cmp l1 l2 вернёт отсортированный список, содержащий все элементы из l1 и l2.

Если несколько элементов сравниваются как равные, элементы l1 будут стоять перед элементами l2. Не рекурсивно по хвосту (сумма длин аргументов).

Итерация по списку.

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