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

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

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

Сравнивает длины двух списков. 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]. Это эквивалентно 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 если в списке 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 если нет значения, связанного с 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. Не рекурсивно по хвосту (сумма длин аргументов).

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

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