The Standard ML Basis Library

The `MONO_VECTOR_SLICE` signature

Synopsis

signature MONO_VECTOR_SLICE structure Word8VectorSlice :> MONO_VECTOR_SLICE where type vector = Word8Vector.vector where type elem = Word8.word structure CharVectorSlice :> MONO_VECTOR_SLICE where type slice = Substring.substring where type vector = String.string where type elem = char structure WideCharVectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type slice = WideSubstring.substring where type vector = WideString.string where type elem = WideChar.char structure BoolVectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type vector = BoolVector.vector where type elem = bool structure IntVectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type vector = IntVector.vector where type elem = int structure WordVectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type vector = WordVector.vector where type elem = word structure RealVectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type vector = RealVector.vector where type elem = real structure LargeIntVectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type vector = LargeIntVector.vector where type elem = LargeInt.int structure LargeWordVectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type vector = LargeWordVector.vector where type elem = LargeWord.word structure LargeRealVectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type vector = LargeRealVector.vector where type elem = LargeReal.real structure Int<N>VectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type elem = Int{N}.int where type vector = Int{N}Vector.vector structure Word<N>VectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type elem = Word{N}.word where type vector = Word{N}Vector.vector structure Real<N>VectorSlice :> MONO_VECTOR_SLICE (* OPTIONAL *) where type elem = Real{N}.real where type vector = Real{N}Vector.vector

The MONO_VECTOR_SLICE signature provides an abstraction of subarrays for monomorphic immutable arrays or vectors. A slice value can be viewed as a triple (v, i, n), where v is the underlying vector, i is the starting index, and n is the length of the subarray, with the constraint that 0 <= i <= i + n <= |v|, where |v| is the length of the vector v. Slices provide a convenient notation for specifying and operating on a contiguous subset of elements in a vector.

Interface

type elem type vector type slice val length : slice -> int val sub : slice * int -> elem val full : vector -> slice val slice : vector * int * int option -> slice val subslice : slice * int * int option -> slice val base : slice -> vector * int * int val vector : slice -> vector val concat : slice list -> vector val isEmpty : slice -> bool val getItem : slice -> (elem * slice) option val appi : (int * elem -> unit) -> slice -> unit val app : (elem -> unit) -> slice -> unit val mapi : (int * elem -> elem) -> slice -> vector val map : (elem -> elem) -> slice -> vector val foldli : (int * elem * 'b -> 'b) -> 'b -> slice -> 'b val foldr : (elem * 'b -> 'b) -> 'b -> slice -> 'b val foldl : (elem * 'b -> 'b) -> 'b -> slice -> 'b val foldri : (int * elem * 'b -> 'b) -> 'b -> slice -> 'b val findi : (int * elem -> bool) -> slice -> (int * elem) option val find : (elem -> bool) -> slice -> elem option val exists : (elem -> bool) -> slice -> bool val all : (elem -> bool) -> slice -> bool val collate : (elem * elem -> order) -> slice * slice -> order

Description

type vector

The underlying monomorphic vector type. We denote the length of a vector vec of type vector by |vec|.

length sl

returns |sl|, the length (i.e., number of elements) of the slice.

sub (sl, i)

returns the i^(th) element of the slice sl. If i < 0 or |sl| <= i, then the Subscript exception is raised.

full vec

creates a slice representing the entire vector vec. It is equivalent to

slice(vec, 0, NONE)

slice (vec, i, sz)

creates a slice based on the vector vec starting at index i of the vector vec. If sz is NONE, the slice includes all of the elements to the end of the vector, i.e., vec[i..|vec|-1]. This raises Subscript if i < 0 or |vec| < i. If sz is SOME(j), the slice has length j, that is, it corresponds to vec[i..i+j-1]. It raises Subscript if i < 0 or j < 0 or |vec| < i + j. Note that, if defined, slice returns an empty slice when i = |vec|.

subslice (sl, i, sz)

creates a slice based on the given slice sl starting at index i of sl. If sz is NONE, the slice includes all of the elements to the end of the slice, i.e., sl[i..|sl|-1]. This raises Subscript if i < 0 or |sl| < i. If sz is SOME(j), the slice has length j, that is, it corresponds to sl[i..i+j-1]. It raises Subscript if i < 0 or j < 0 or |sl| < i + j. Note that, if defined, slice returns an empty slice when i = |sl|.

base sl

returns a triple (vec, i, n) representing the concrete representation of the slice. vec is the underlying vector, i is the starting index, and n is the length of the slice.

vector sl

generates a vector from the slice sl. Specifically, if vec is the resulting vector, we have |vec| = |sl| and, for 0 <= i < |sl|, element i of vec is sub (sl, i).

concat l

is the concatenation of all the vectors in l. This raises Size if the sum of all the lengths is greater than the maximum length allowed by vectors of type vector.

isEmpty sl

returns true if sl has length 0.

getItem sl

returns the first item in sl and the rest of the slice, or NONE if sl is empty.

appi f sl

app f sl

These apply the function f to the elements of a slice in left to right order (i.e., increasing indices). The more general appi function supplies f with the index of the corresponding element in the slice. The expression app f sl is equivalent to appi (f o #2) sl.

mapi f sl

map f sl

These functions generate new vectors by mapping the function f from left to right over the argument slice. The more general mapi function supplies both the element and the element's index in the slice to the function f. The latter expression is equivalent to:

      mapi (f o #2) sl

foldli f init sl

foldr f init sl

foldl f init sl

foldri f init sl

These fold the function f over all the elements of a vector slice, using the value init as the initial value. The functions foldli and foldl apply the function f from left to right (increasing indices), while the functions foldri and foldr work from right to left (decreasing indices). The more general functions foldli and foldri supply f with the index of the corresponding element in the slice.

Refer to the MONO_ARRAY manual pages for reference implementations of the indexed versions.

The expression foldl f init sl is equivalent to:

foldli (fn (_, a, x) => f(a, x)) init sl

The analogous equivalence holds for foldri and foldr.

findi f sl

find f sl

These apply f to each element of the slice sl, from left to right (i.e., increasing indices), until a true value is returned. If this occurs, the functions return the element; otherwise, they return NONE. The more general version findi also supplies f with the index of the element in the slice and, upon finding an entry satisfying the predicate, returns that index with the element.

exists f sl

applies f to each element x of the slice sl, from left to right (i.e., increasing indices), until f x evaluates to true; it returns true if such an x exists and false otherwise.

all f sl

applies f to each element x of the slice sl, from left to right (i.e., increasing indices), until f x evaluates to false; it returns false if such an x exists and true otherwise. It is equivalent to not(exists (not o f) sl)).

collate f (sl, sl2)

performs lexicographic comparison of the two slices using the given ordering f on elements.

Discussion

If an implementation provides a structure matching MONO_VECTOR_SLICE for some element type ty, it must provide the corresponding monomorphic structure matching MONO_VECTOR with the vector types in the two structures identified.

[ Top | Parent | Contents | Index | Root ]

Generated April 12, 2004
Last Modified June 20, 2000
Comments to John Reppy.

This document may be distributed freely over the internet as long as the copyright notice and license terms below are prominently displayed within every machine-readable copy.

Copyright © 2004 AT&T and Lucent Technologies. All rights reserved.
Permission is granted for internet users to make one paper copy for their own personal use. Further hardcopy reproduction is strictly prohibited. Permission to distribute the HTML document electronically on any medium other than the internet must be requested from the copyright holders by contacting the editors. Printed versions of the SML Basis Manual are available from Cambridge University Press. To order, please visit www.cup.org (North America) or www.cup.cam.ac.uk (outside North America).