Module

Data.Sequence.Ordered

Package
purescript-sequences
Repository
hdgarrood/purescript-sequences

This module defines a sequence where elements are always kept in order. This enables constant time access to the least and greatest elements, in addition to logarithmic time partitioning.

The module is intended to be imported qualified, to avoid ambiguity or name clashes. For example:

import Data.Sequence.Ordered (OrdSeq)
import Data.Sequence.Ordered as OrdSeq

#OrdSeq Source

newtype OrdSeq a

An ordered sequence. The Semigroup instance uses the merge function.

Instances

#empty Source

empty :: forall a. OrdSeq a

#null Source

null :: forall a. OrdSeq a -> Boolean

O(1). Returns true if the given sequence is empty, false otherwise.

#length Source

length :: forall a. OrdSeq a -> Int

O(n). Return the length of the sequence.

#partition Source

partition :: forall a. Ord a => a -> OrdSeq a -> Tuple (OrdSeq a) (OrdSeq a)

O(log(n)). Split an ordered sequence into two halves. The first element of the returned tuple contains all elements which compared less than or equal to the argument; the second element contains the rest.

#insert Source

insert :: forall a. Ord a => a -> OrdSeq a -> OrdSeq a

O(log(n)). Insert the given value into the correct place in the sequence.

#deleteAll Source

deleteAll :: forall a. Ord a => a -> OrdSeq a -> OrdSeq a

O(log(n)). Delete all elements from the sequence which compare EQ to the given value.

#merge Source

merge :: forall a. Ord a => OrdSeq a -> OrdSeq a -> OrdSeq a

O(m*log(n/m)), where m and n are the lengths of the longer and shorter sequences respectively. Create a new sequence containing every element in both of the given sequences.

#intersection Source

intersection :: forall a. Ord a => OrdSeq a -> OrdSeq a -> OrdSeq a

O(n*log(n)), where n is the length of the longer sequence. Create a new sequence containing only elements which are common to both sequences.

#least Source

least :: forall a. Ord a => OrdSeq a -> Maybe a

O(1). Access the least element of the sequence, or Nothing if the sequence is empty.

#popLeast Source

popLeast :: forall a. Ord a => OrdSeq a -> Maybe (Tuple a (OrdSeq a))

O(1). Remove the least element of the sequence, returning that element and the remainder of the sequence. If the sequence is empty, return Nothing.

#greatest Source

greatest :: forall a. Ord a => OrdSeq a -> Maybe a

O(1). Access the greatest element of the sequence, or Nothing if the sequence is empty.

#popGreatest Source

popGreatest :: forall a. Ord a => OrdSeq a -> Maybe (Tuple a (OrdSeq a))

O(1). Remove the greatest element of the sequence, returning that element and the remainder of the sequence. If the sequence is empty, return Nothing.

#fromFoldable Source

fromFoldable :: forall a f. Foldable f => Ord a => f a -> OrdSeq a

Probably O(n*log(n)), but depends on the Foldable instance. Consruct an ordered sequence from any any Foldable.

#toUnfoldable Source

toUnfoldable :: forall f. Functor f => Unfoldable f => OrdSeq ~> f

Probably O(n), but depends on the Unfoldable instance. Unfold an ordered sequence in ascending order.

#toUnfoldableDescending Source

toUnfoldableDescending :: forall a f. Functor f => Unfoldable f => OrdSeq a -> f a

Probably O(n), but depends on the Unfoldable instance. Unfold an ordered sequence in descending order.

#sort Source

sort :: forall a f. Functor f => Foldable f => Unfoldable f => Ord a => f a -> f a

Sort any structure (which has Foldable, Unfoldable, and Functor instances) by converting to an OrdSeq and back again. I am fairly sure this is usually O(n*log(n)), although of course this depends on the Unfoldable and Foldable instances.