Модуль StdLabels.List

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

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

Сравнивает длины двух списков. 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. Это эквивалентно (ListLabels.rev l1) @ l2, но rev_append является хвостовой рекурсией и более эффективной.

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

То же, что 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. Это эквивалентно begin f a1; f a2; ...; f an; () end.

То же, что 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 если в списке l нет значения, удовлетворяющего предикату f.

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

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

Аналогично 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. Не рекурсивно по хвосту (сумма длин аргументов).

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

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