Progeneric.Ptl.Algorithms

Class Algobase

java.lang.Object

Progeneric.Ptl.Algorithms.Algobase

public final class Algobase
extends java.lang.Object

Implements basic algorithms that operate on ranges of iterators.

Field Summary

Fields

Modifier and Type	Field and Description
static int	LOG2_PARTITION_SIZE The binary log of the partition size.
static int	PARTITION_SIZE The size of a range (partition) that can be processed in parallel.

Method Summary

Methods

Modifier and Type	Method and Description
static <T extends java.lang.Comparable<T>> int	Compare(T[] x, int first1, int last1, T[] y, int first2) Compares two ranges element by element and returns an indication of their relative values.
static <T> int	Compare(T[] x, int first1, int last1, T[] y, int first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> int	Compare(TInpIter first1, long n, TInpIter first2) Compares two ranges element by element and returns an indication of their relative values.
static <T,TInpIter extends IInpIter<T,TInpIter>> int	Compare(TInpIter first1, long n, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> int	Compare(TInpIter first1, TInpIter last1, TInpIter first2) Compares two ranges element by element and returns an indication of their relative values.
static <T,TInpIter extends IInpIter<T,TInpIter>> int	Compare(TInpIter first1, TInpIter last1, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.
static <T> int	Copy(IStreamable<T>[] x, int first1, int last1, IStreamable<T>[] y, int first2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T> int	Copy(IStreamable<T>[] x, int first1, int last1, T[] y, int first2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T> int	Copy(T[] x, int first1, int last1, T[] y, int first2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T> int	Copy(T[] x, int first1, int last1, T[] y, int first2, IFunc1Arg<T,java.lang.Boolean> pred) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TOutIter extends IOutIter<T,TOutIter>> TOutIter	Copy(T[] x, int first1, int last1, TOutIter first2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>> int	Copy(TInpIter first1, int n, T[] x, int first2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter	Copy(TInpIter first1, long n, TOutIter first2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter	Copy(TInpIter first1, long n, TOutIter first2, IFunc1Arg<T,java.lang.Boolean> pred) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>> int	Copy(TInpIter first1, TInpIter last1, T[] x, int first2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter	Copy(TInpIter first1, TInpIter last1, TOutIter first2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter	Copy(TInpIter first1, TInpIter last1, TOutIter first2, IFunc1Arg<T,java.lang.Boolean> pred) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T> int	CopyBackward(IStreamable<T>[] x, int first1, int last1, IStreamable<T>[] y, int last2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T> int	CopyBackward(T[] x, int first1, int last1, T[] y, int last2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T> int	CopyBackward(T[] x, int first1, int last1, T[] y, int last2, IFunc1Arg<T,java.lang.Boolean> pred) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter	CopyBackward(T[] x, int first1, int last1, TBidIter last2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> int	CopyBackward(TBidIter last1, int n, T[] x, int last2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter	CopyBackward(TBidIter last1, long n, TBidIter last2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter	CopyBackward(TBidIter last1, long n, TBidIter last2, IFunc1Arg<T,java.lang.Boolean> pred) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> int	CopyBackward(TBidIter first1, TBidIter last1, T[] x, int last2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter	CopyBackward(TBidIter first1, TBidIter last1, TBidIter last2) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter	CopyBackward(TBidIter first1, TBidIter last1, TBidIter last2, IFunc1Arg<T,java.lang.Boolean> pred) Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T> int	Count(T[] x, int first, int last, IPredicate<T> pred) Returns the number of elements in a range whose values satisfy a specified condition.
static <T> int	Count(T[] x, int first, int last, T value) Returns the number of elements in a range whose values match a specified value.
static <T,TInpIter extends IInpIter<T,TInpIter>> long	Count(TInpIter first, long n, IPredicate<T> pred) Returns the number of elements in a range whose values satisfy a specified condition.
static <T,TInpIter extends IInpIter<T,TInpIter>> long	Count(TInpIter first, long n, T value) Returns the number of elements in a range whose values match a specified value.
static <T,TInpIter extends IInpIter<T,TInpIter>> long	Count(TInpIter first, TInpIter last, IPredicate<T> pred) Returns the number of elements in a range whose values satisfy a specified condition.
static <T,TInpIter extends IInpIter<T,TInpIter>> long	Count(TInpIter first, TInpIter last, T value) Returns the number of elements in a range whose values match a specified value.
static <T> boolean	Equal(T[] x, int first1, int last1, T[] y, int first2) Compares two ranges element by element for equality.
static <T> boolean	Equal(T[] x, int first1, int last1, T[] y, int first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element for equivalence based on a binary predicate.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	Equal(TInpIter first1, long n, TInpIter first2) Compares two ranges element by element for equality.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	Equal(TInpIter first1, long n, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element for equivalence in a sense specified by a binary predicate.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	Equal(TInpIter first1, TInpIter last1, TInpIter first2) Compares two ranges element by element for equality.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	Equal(TInpIter first1, TInpIter last1, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element for equivalence based on a binary predicate.
static <T> void	ForEach(T[] x, int first, int last, IAction2Arg<T[],java.lang.Integer> func) Applies a specified function object in a forward order to each element in a range.
static <T> void	ForEach(T[] x, int first, int last, IPredicate<T> pred, IAction2Arg<T[],java.lang.Integer> func) Applies a specified function object in a forward order to all elements in a range that satisfy a predicate.
static <T,TFwdIter extends IInpIter<T,TFwdIter>> void	ForEach(TFwdIter first, long n, IAction1Arg<TFwdIter> func) Applies a specified function object in a forward order to each iterator in a range.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void	ForEach(TFwdIter first, long n, IPredicate<T> pred, IAction1Arg<TFwdIter> func) Applies a specified function object in a forward order to all iterators in a range that satisfy a predicate.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void	ForEach(TFwdIter first, TFwdIter last, IAction1Arg<TFwdIter> func) Applies a specified function object in a forward order to each iterator in a range.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void	ForEach(TFwdIter first, TFwdIter last, IPredicate<T> pred, IAction1Arg<TFwdIter> func) Applies a specified function object in a forward order to all iterators in a range that satisfy a predicate.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void	IterSwap(TFwdIter iter1, TFwdIter iter2) Exchanges the values (contents) between two iterators.
static <T extends java.lang.Comparable<T>> boolean	LexicographicalCompare(T[] x, int first1, int last1, T[] y, int first2, int last2) Compares two ranges element by element to determine which is the lesser of the two.
static <T> boolean	LexicographicalCompare(T[] x, int first1, int last1, T[] y, int first2, int last2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element to determine which is the lesser of the two based on a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> boolean	LexicographicalCompare(TInpIter first1, TInpIter last1, TInpIter first2, TInpIter last2) Compares two ranges element by element to determine which is the lesser of the two.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> boolean	LexicographicalCompare(TInpIter first1, TInpIter last1, TInpIter first2, TInpIter last2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element to determine which is the lesser of the two based on a binary predicate.
static <T extends java.lang.Comparable<T>> T	Max(T x, T y) Compares two objects and returns the larger of the two.
static <T> T	Max(T x, T y, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two objects and returns the larger of the two, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>> int	MaxElement(T[] x, int first, int last) Finds the first occurrence of the largest element in a specified range.
static <T> int	MaxElement(T[] x, int first, int last, IFunc2Arg<T,T,java.lang.Boolean> pred) Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter	MaxElement(TInpIter first, long n) Finds the first occurrence of the largest element in a specified range.
static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter	MaxElement(TInpIter first, long n, IFunc2Arg<T,T,java.lang.Boolean> pred) Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter	MaxElement(TInpIter first, TInpIter last) Finds the first occurrence of the largest element in a specified range.
static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter	MaxElement(TInpIter first, TInpIter last, IFunc2Arg<T,T,java.lang.Boolean> pred) Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>> T	Min(T x, T y) Compares two objects and returns the lesser of the two.
static <T> T	Min(T x, T y, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two objects and returns the lesser of the two, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>> int	MinElement(T[] x, int first, int last) Finds the first occurrence of the smallest element in a specified range.
static <T> int	MinElement(T[] x, int first, int last, IFunc2Arg<T,T,java.lang.Boolean> pred) Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter	MinElement(TInpIter first, long n) Finds the first occurrence of the smallest element in a specified range.
static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter	MinElement(TInpIter first, long n, IFunc2Arg<T,T,java.lang.Boolean> pred) Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter	MinElement(TInpIter first, TInpIter last) Finds the first occurrence of the smallest element in a specified range.
static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter	MinElement(TInpIter first, TInpIter last, IFunc2Arg<T,T,java.lang.Boolean> pred) Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T> Tuple2<java.lang.Integer,java.lang.Integer>	Mismatch(T[] x, int first1, int last1, T[] y, int first2) Compares two ranges element by element for equality and locates the first position where a difference occurs.
static <T> Tuple2<java.lang.Integer,java.lang.Integer>	Mismatch(T[] x, int first1, int last1, T[] y, int first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element for equivalence based on a binary predicate and locates the first position where a difference occurs.
static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter>	Mismatch(TInpIter first1, long n, TInpIter first2) Compares two ranges element by element for equivalence and locates the first position where a difference occurs.
static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter>	Mismatch(TInpIter first1, long n, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element for equivalence based on a binary predicate and locates the first position where a difference occurs.
static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter>	Mismatch(TInpIter first1, TInpIter last1, TInpIter first2) Compares two ranges element by element for equality and locates the first position where a difference occurs.
static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter>	Mismatch(TInpIter first1, TInpIter last1, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Compares two ranges element by element for equivalence based on a binary predicate and locates the first position where a difference occurs.
static Tuple2<java.lang.Integer,java.lang.Integer>	Partition(int size) Partitions the range [0, size) into blocks of PARTITION_SIZE.
static Tuple2<java.lang.Integer,java.lang.Integer>	Partition(int size, int partitionSize) Partitions the range [0, size) into blocks of partitionSize.
static Tuple2<java.lang.Long,java.lang.Integer>	Partition(long size) Partitions the range [0, size) into blocks of PARTITION_SIZE.
static Tuple2<java.lang.Long,java.lang.Integer>	Partition(long size, int partitionSize) Partitions the range [0, size) into blocks of partitionSize.
static <T extends java.lang.Comparable<T>> int	PCompare(T[] x, int first1, int last1, T[] y, int first2) Parallel Compare: Compares two ranges element by element and returns an indication of their relative values.
static <T> int	PCompare(T[] x, int first1, int last1, T[] y, int first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Compare: Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> int	PCompare(TInpIter first1, long n, TInpIter first2) Parallel Compare: Compares two ranges element by element and returns an indication of their relative values.
static <T,TInpIter extends IInpIter<T,TInpIter>> int	PCompare(TInpIter first1, long n, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Compare: Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> int	PCompare(TInpIter first1, TInpIter last1, TInpIter first2) Parallel Compare: Compares two ranges element by element and returns an indication of their relative values.
static <T,TInpIter extends IInpIter<T,TInpIter>> int	PCompare(TInpIter first1, TInpIter last1, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Compare: Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.
static <T> int	PCopy(T[] x, int first1, int last1, T[] y, int first2) Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TOutIter extends IOutIter<T,TOutIter>> TOutIter	PCopy(T[] x, int first1, int last1, TOutIter first2) Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>> int	PCopy(TInpIter first1, int n, T[] x, int first2) Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter	PCopy(TInpIter first1, long n, TOutIter first2) Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>> int	PCopy(TInpIter first1, TInpIter last1, T[] x, int first2) Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter	PCopy(TInpIter first1, TInpIter last1, TOutIter first2) Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.
static <T> int	PCopyBackward(T[] x, int first1, int last1, T[] y, int last2) Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter	PCopyBackward(T[] x, int first1, int last1, TBidIter last2) Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> int	PCopyBackward(TBidIter last1, int n, T[] x, int last2) Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter	PCopyBackward(TBidIter last1, long n, TBidIter last2) Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> int	PCopyBackward(TBidIter first1, TBidIter last1, T[] x, int last2) Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter	PCopyBackward(TBidIter first1, TBidIter last1, TBidIter last2) Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.
static <T> int	PCount(T[] x, int first, int last, IPredicate<T> pred) Parallel Count: Returns the number of elements in a range whose values satisfy a specified condition.
static <T> int	PCount(T[] x, int first, int last, T value) Parallel Count: Returns the number of elements in a range whose values match a specified value.
static <T,TInpIter extends IInpIter<T,TInpIter>> long	PCount(TInpIter first, long n, IPredicate<T> pred) Parallel Count: Returns the number of elements in a range whose values satisfy a specified condition.
static <T,TInpIter extends IInpIter<T,TInpIter>> long	PCount(TInpIter first, long n, T value) Parallel Count: Returns the number of elements in a range whose values match a specified value.
static <T,TInpIter extends IInpIter<T,TInpIter>> long	PCount(TInpIter first, TInpIter last, IPredicate<T> pred) Parallel Count: Returns the number of elements in a range whose values satisfy a specified condition.
static <T,TInpIter extends IInpIter<T,TInpIter>> long	PCount(TInpIter first, TInpIter last, T value) Parallel Count: Returns the number of elements in a range whose values match a specified value.
static <T> boolean	PEqual(T[] x, int first1, int last1, T[] y, int first2) Parallel Equal: Compares two ranges element by element for equality.
static <T> boolean	PEqual(T[] x, int first1, int last1, T[] y, int first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Equal: Compares two ranges element by element for equivalence based on a binary predicate.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	PEqual(TInpIter first1, long n, TInpIter first2) Parallel Equal: Compares two ranges element by element for equality.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	PEqual(TInpIter first1, long n, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Equal: Compares two ranges element by element for equivalence in a sense specified by a binary predicate.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	PEqual(TInpIter first1, TInpIter last1, TInpIter first2) Parallel Equal: Compares two ranges element by element for equality.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	PEqual(TInpIter first1, TInpIter last1, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Equal: Compares two ranges element by element for equivalence based on a binary predicate.
static <T> void	PForEach(T[] x, int first, int last, IAction2Arg<T[],java.lang.Integer> func) Parallel ForEach: Applies a specified function object in a forward order to each element in a range.
static <T> void	PForEach(T[] x, int first, int last, IPredicate<T> pred, IAction2Arg<T[],java.lang.Integer> func) Parallel ForEach: Applies a specified function object in a forward order to all elements in a range that satisfy a predicate.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void	PForEach(TFwdIter first, long n, IAction1Arg<TFwdIter> func) Parallel ForEach: Applies a specified function object in a forward order to each iterator in a range.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void	PForEach(TFwdIter first, long n, IPredicate<T> pred, IAction1Arg<TFwdIter> func) Parallel ForEach: Applies a specified function object in a forward order to all iterators in a range that satisfy a predicate.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void	PForEach(TFwdIter first, TFwdIter last, IAction1Arg<TFwdIter> func) Parallel ForEach: Applies a specified function object in a forward order to each iterator in a range.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void	PForEach(TFwdIter first, TFwdIter last, IPredicate<T> pred, IAction1Arg<TFwdIter> func) Parallel ForEach: Applies a specified function object in a forward order to all iterators in a range that satisfy a predicate.
static <T extends java.lang.Comparable<T>> boolean	PLexicographicalCompare(T[] x, int first1, int last1, T[] y, int first2, int last2) Parallel LexicographicalCompare: Compares two ranges element by element to determine which is the lesser of the two.
static <T> boolean	PLexicographicalCompare(T[] x, int first1, int last1, T[] y, int first2, int last2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel LexicographicalCompare: Compares two ranges element by element to determine which is the lesser of the two based on a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> boolean	PLexicographicalCompare(TInpIter first1, TInpIter last1, TInpIter first2, TInpIter last2) Parallel LexicographicalCompare: Compares two ranges element by element to determine which is the lesser of the two.
static <T,TInpIter extends IInpIter<T,TInpIter>> boolean	PLexicographicalCompare(TInpIter first1, TInpIter last1, TInpIter first2, TInpIter last2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel LexicographicalCompare: Compares two ranges element by element to determine which is the lesser of the two based on a binary predicate.
static <T extends java.lang.Comparable<T>> int	PMaxElement(T[] x, int first, int last) Parallel MaxElement: Finds the first occurrence of the largest element in a specified range.
static <T> int	PMaxElement(T[] x, int first, int last, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel MaxElement: Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter	PMaxElement(TInpIter first, long n) Parallel MaxElement: Finds the first occurrence of the largest element in a specified range.
static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter	PMaxElement(TInpIter first, long n, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel MaxElement: Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter	PMaxElement(TInpIter first, TInpIter last) Parallel MaxElement: Finds the first occurrence of the largest element in a specified range.
static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter	PMaxElement(TInpIter first, TInpIter last, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel MaxElement: Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>> int	PMinElement(T[] x, int first, int last) Parallel MinElement: Finds the first occurrence of the smallest element in a specified range.
static <T> int	PMinElement(T[] x, int first, int last, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel MinElement: Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter	PMinElement(TInpIter first, long n) Parallel MinElement: Finds the first occurrence of the smallest element in a specified range.
static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter	PMinElement(TInpIter first, long n, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel MinElement: Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter	PMinElement(TInpIter first, TInpIter last) Parallel MinElement: Finds the first occurrence of the smallest element in a specified range.
static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter	PMinElement(TInpIter first, TInpIter last, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel MinElement: Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.
static <T> Tuple2<java.lang.Integer,java.lang.Integer>	PMismatch(T[] x, int first1, int last1, T[] y, int first2) Parallel Mismatch: Compares two ranges element by element for equality and locates the first position where a difference occurs.
static <T> Tuple2<java.lang.Integer,java.lang.Integer>	PMismatch(T[] x, int first1, int last1, T[] y, int first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Mismatch: Compares two ranges element by element for equivalence based on a binary predicate and locates the first position where a difference occurs.
static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter>	PMismatch(TInpIter first1, long n, TInpIter first2) Parallel Mismatch: Compares two ranges element by element for equivalence and locates a position where a difference occurs.
static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter>	PMismatch(TInpIter first1, long n, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Mismatch: Compares two ranges element by element for equivalence based on a binary predicate and locates a position where a difference occurs.
static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter>	PMismatch(TInpIter first1, TInpIter last1, TInpIter first2) Parallel Mismatch: Compares two ranges element by element for equality and locates a position where a difference occurs.
static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter>	PMismatch(TInpIter first1, TInpIter last1, TInpIter first2, IFunc2Arg<T,T,java.lang.Boolean> pred) Parallel Mismatch: Compares two ranges element by element for equivalence based on a binary predicate and locates a position where a difference occurs.
static <T> void	PProcess(T[] data, int first, int last, IAction3Arg<T[],java.lang.Integer,java.lang.Integer> func) Parallel Process: Applies a specified function to each element in current container.
static <T> int	PSwapRanges(T[] x, int first1, int last1, T[] y, int first2) Parallel SwapRanges: Exchanges the contents of two ranges of equal size.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> TFwdIter	PSwapRanges(TFwdIter first1, long n, TFwdIter first2) Parallel SwapRanges: Exchanges the contents of two ranges of equal size.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> TFwdIter	PSwapRanges(TFwdIter first1, TFwdIter last1, TFwdIter first2) Parallel SwapRanges: Exchanges the contents of two ranges of equal size.
static <T,TResult> int	PTransform(T[] x, int first1, int last1, TResult[] y, int first2, IFunc1Arg<T,TResult> func) Parallel Transform: Applies a specified function to each element in a source range and copies the return values of the function into a destination range.
static <T1,T2,TResult> int	PTransform(T1[] x, int first1, int last1, T2[] y, int first2, TResult[] z, int result, IFunc2Arg<T1,T2,TResult> func) Parallel Transform: Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.
static <T1,TInpIter1 extends IInpIter<T1,TInpIter1>,T2,TInpIter2 extends IInpIter<T2,TInpIter2>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter	PTransform(TInpIter1 first1, long n, TInpIter2 first2, TOutIter result, IFunc2Arg<T1,T2,TResult> func) Parallel Transform: Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.
static <T1,TInpIter1 extends IInpIter<T1,TInpIter1>,T2,TInpIter2 extends IInpIter<T2,TInpIter2>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter	PTransform(TInpIter1 first1, TInpIter1 last1, TInpIter2 first2, TOutIter result, IFunc2Arg<T1,T2,TResult> func) Parallel Transform: Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.
static <T,TInpIter extends IInpIter<T,TInpIter>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter	PTransform(TInpIter first1, long n, TOutIter first2, IFunc1Arg<T,TResult> func) Parallel Transform: Applies a specified function to each element in a source range and copies the return values of the function into a destination range.
static <T,TInpIter extends IInpIter<T,TInpIter>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter	PTransform(TInpIter first, TInpIter last, TOutIter result, IFunc1Arg<T,TResult> func) Parallel Transform: Applies a specified function to each element in a source range and copies the return values of the function into a destination range.
static <T> void	Swap(T[] x, int idx1, int idx2) Exchanges the values of the elements between two array elements, assigning the contents of the first object to the second object and the contents of the second to the first.
static <T> int	SwapRanges(T[] x, int first1, int last1, T[] y, int first2) Exchanges the contents of two ranges of equal size.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> TFwdIter	SwapRanges(TFwdIter first1, long n, TFwdIter first2) Exchanges the contents of two ranges of equal size.
static <T,TFwdIter extends IFwdIter<T,TFwdIter>> TFwdIter	SwapRanges(TFwdIter first1, TFwdIter last1, TFwdIter first2) Exchanges the contents of two ranges of equal size.
static <T> void	ToStream(T[] data, int first, int last, java.io.PrintStream sw) Writes the elements of the specified range to the specified stream.
static <T,TBidIter extends IBidIter<T,TBidIter>> void	ToStream(TBidIter first, long n, java.io.PrintStream sw) Writes the elements of the specified range to the specified stream.
static <T,TBidIter extends IBidIter<T,TBidIter>> void	ToStream(TBidIter first, TBidIter last, java.io.PrintStream sw) Writes the elements of the specified range to the specified stream.
static <T> java.lang.String	ToString(T[] data, int first, int last) Returns a string that represents the elements of the specified range.
static <T,TBidIter extends IBidIter<T,TBidIter>> java.lang.String	ToString(TBidIter first, TBidIter last) Returns a string that represents the elements of the specified range.
static <T,TResult> int	Transform(T[] x, int first, int last, TResult[] y, int result, IFunc1Arg<T,TResult> func) Applies a specified function to each element in a source range and copies the return values of the function into a destination range.
static <T1,T2,TResult> int	Transform(T1[] x, int first1, int last1, T2[] y, int first2, TResult[] z, int result, IFunc2Arg<T1,T2,TResult> func) Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.
static <T1,TInpIter1 extends IInpIter<T1,TInpIter1>,T2,TInpIter2 extends IInpIter<T2,TInpIter2>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter	Transform(TInpIter1 first1, long n, TInpIter2 first2, TOutIter result, IFunc2Arg<T1,T2,TResult> func) Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.
static <T1,TInpIter1 extends IInpIter<T1,TInpIter1>,T2,TInpIter2 extends IInpIter<T2,TInpIter2>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter	Transform(TInpIter1 first1, TInpIter1 last1, TInpIter2 first2, TOutIter result, IFunc2Arg<T1,T2,TResult> func) Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.
static <T,TInpIter extends IInpIter<T,TInpIter>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter	Transform(TInpIter first, long n, TOutIter result, IFunc1Arg<T,TResult> func) Applies a specified function to each element in a source range and copies the return values of the function into a destination range.
static <T,TInpIter extends IInpIter<T,TInpIter>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter	Transform(TInpIter first, TInpIter last, TOutIter result, IFunc1Arg<T,TResult> func) Applies a specified function to each element in a source range and copies the return values of the function into a destination range.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PARTITION_SIZE

public static final int PARTITION_SIZE

The size of a range (partition) that can be processed in parallel.

See Also:

Constant Field Values

LOG2_PARTITION_SIZE

public static final int LOG2_PARTITION_SIZE

The binary log of the partition size.

See Also:

Constant Field Values

Method Detail

Equal

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean Equal(TInpIter first1,
                                                      TInpIter last1,
                                                      TInpIter first2)

Compares two ranges element by element for equality.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

last1 - An input iterator addressing the position one past the final element in the first range to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

Returns:

True if and only if the ranges are identical when compared element by element; otherwise, false.

Equal

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean Equal(TInpIter first1,
                                                      long n,
                                                      TInpIter first2)

Compares two ranges element by element for equality.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

n - The number of elements in the specified ranges to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

Returns:

True if and only if the ranges are identical when compared element by element; otherwise, false.

PEqual

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean PEqual(TInpIter first1,
                                                       TInpIter last1,
                                                       TInpIter first2)

Parallel Equal: Compares two ranges element by element for equality.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

last1 - An input iterator addressing the position one past the final element in the first range to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

Returns:

True if and only if the ranges are identical when compared element by element; otherwise, false.

PEqual

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean PEqual(TInpIter first1,
                                                       long n,
                                                       TInpIter first2)

Parallel Equal: Compares two ranges element by element for equality.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

n - The number of elements in the specified ranges to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

Returns:

True if and only if the ranges are identical when compared element by element; otherwise, false.

Equal

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean Equal(TInpIter first1,
                                                      TInpIter last1,
                                                      TInpIter first2,
                                                      IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element for equivalence based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

last1 - An input iterator addressing the position one past the final element in the first range to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if and only if the ranges are equivalent under the binary predicate when compared element by element; otherwise, false.

Equal

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean Equal(TInpIter first1,
                                                      long n,
                                                      TInpIter first2,
                                                      IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element for equivalence in a sense specified by a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

n - The number of elements in the specified ranges to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if and only if the ranges are equivalent under the binary predicate when compared element by element; otherwise, false.

PEqual

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean PEqual(TInpIter first1,
                                                       TInpIter last1,
                                                       TInpIter first2,
                                                       IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Equal: Compares two ranges element by element for equivalence based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

last1 - An input iterator addressing the position one past the final element in the first range to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if and only if the ranges are equivalent under the binary predicate when compared element by element; otherwise, false.

PEqual

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean PEqual(TInpIter first1,
                                                       long n,
                                                       TInpIter first2,
                                                       IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Equal: Compares two ranges element by element for equivalence in a sense specified by a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

n - The number of elements in the specified ranges to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if and only if the ranges are equivalent under the binary predicate when compared element by element; otherwise, false.

Equal

public static <T> boolean Equal(T[] x,
                int first1,
                int last1,
                T[] y,
                int first2)

Compares two ranges element by element for equality.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be tested.

last1 - An integer addressing the position one past the final element in the first range to be tested.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be tested.

Returns:

True if and only if the ranges are identical when compared element by element; otherwise, false.

PEqual

public static <T> boolean PEqual(T[] x,
                 int first1,
                 int last1,
                 T[] y,
                 int first2)

Parallel Equal: Compares two ranges element by element for equality.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be tested.

last1 - An integer addressing the position one past the final element in the first range to be tested.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be tested.

Returns:

True if and only if the ranges are identical when compared element by element; otherwise, false.

Equal

public static <T> boolean Equal(T[] x,
                int first1,
                int last1,
                T[] y,
                int first2,
                IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element for equivalence based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be tested.

last1 - An integer addressing the position one past the final element in the first range to be tested.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if and only if the ranges are equivalent under the binary predicate when compared element by element; otherwise, false.

PEqual

public static <T> boolean PEqual(T[] x,
                 int first1,
                 int last1,
                 T[] y,
                 int first2,
                 IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Equal: Compares two ranges element by element for equivalence based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be tested.

last1 - An integer addressing the position one past the final element in the first range to be tested.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if and only if the ranges are equivalent under the binary predicate when compared element by element; otherwise, false.

Compare

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> int Compare(TInpIter first1,
                                                                                    TInpIter last1,
                                                                                    TInpIter first2)

Compares two ranges element by element and returns an indication of their relative values.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

last1 - An input iterator addressing the position one past the final element in the first range to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

java.lang.RuntimeException - Thrown when any of the specified ranges are invalid.

Compare

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> int Compare(TInpIter first1,
                                                                                    long n,
                                                                                    TInpIter first2)

Compares two ranges element by element and returns an indication of their relative values.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

n - The number of elements in the specified ranges to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

java.lang.RuntimeException - Thrown when any of the specified ranges are invalid.

Compare

public static <T,TInpIter extends IInpIter<T,TInpIter>> int Compare(TInpIter first1,
                                                    TInpIter last1,
                                                    TInpIter first2,
                                                    IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

last1 - An input iterator addressing the position one past the final element in the first range to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

java.lang.RuntimeException - Thrown when any of the specified ranges are invalid.

Compare

public static <T,TInpIter extends IInpIter<T,TInpIter>> int Compare(TInpIter first1,
                                                    long n,
                                                    TInpIter first2,
                                                    IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

n - The number of elements in the specified ranges to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

java.lang.RuntimeException - Thrown when any of the specified ranges are invalid.

PCompare

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> int PCompare(TInpIter first1,
                                                                                     TInpIter last1,
                                                                                     TInpIter first2)

Parallel Compare: Compares two ranges element by element and returns an indication of their relative values.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

last1 - An input iterator addressing the position one past the final element in the first range to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

java.lang.RuntimeException - Thrown when any of the specified ranges are invalid.

PCompare

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> int PCompare(TInpIter first1,
                                                                                     long n,
                                                                                     TInpIter first2)

Parallel Compare: Compares two ranges element by element and returns an indication of their relative values.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

n - The number of elements in the specified ranges to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

java.lang.RuntimeException - Thrown when any of the specified ranges are invalid.

PCompare

public static <T,TInpIter extends IInpIter<T,TInpIter>> int PCompare(TInpIter first1,
                                                     TInpIter last1,
                                                     TInpIter first2,
                                                     IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Compare: Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

last1 - An input iterator addressing the position one past the final element in the first range to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

java.lang.RuntimeException - Thrown when any of the specified ranges are invalid.

PCompare

public static <T,TInpIter extends IInpIter<T,TInpIter>> int PCompare(TInpIter first1,
                                                     long n,
                                                     TInpIter first2,
                                                     IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Compare: Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

n - The number of elements in the specified ranges to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

java.lang.RuntimeException - Thrown when any of the specified ranges are invalid.

Compare

public static <T extends java.lang.Comparable<T>> int Compare(T[] x,
                                              int first1,
                                              int last1,
                                              T[] y,
                                              int first2)

Compares two ranges element by element and returns an indication of their relative values.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be compared.

last1 - An integer addressing the position one past the final element in the first range to be compared.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be compared.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

IndexOutOfRangeException - Thrown when any of the specified ranges is invalid.

Compare

public static <T> int Compare(T[] x,
              int first1,
              int last1,
              T[] y,
              int first2,
              IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be compared.

last1 - An integer addressing the position one past the final element in the first range to be compared.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

IndexOutOfRangeException - Thrown when any of the specified ranges is invalid.

PCompare

public static <T extends java.lang.Comparable<T>> int PCompare(T[] x,
                                               int first1,
                                               int last1,
                                               T[] y,
                                               int first2)

Parallel Compare: Compares two ranges element by element and returns an indication of their relative values.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be compared.

last1 - An integer addressing the position one past the final element in the first range to be compared.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be compared.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

IndexOutOfRangeException - Thrown when any of the specified ranges is invalid.

PCompare

public static <T> int PCompare(T[] x,
               int first1,
               int last1,
               T[] y,
               int first2,
               IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Compare: Compares two ranges element by element and returns an indication of their relative values based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be compared.

last1 - An integer addressing the position one past the final element in the first range to be compared.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

Less than zero	The first range is less than the second range.
Zero	The first range is equal to the second range.
Greater than zero	The first range is greater than the second range.

Throws:

IndexOutOfRangeException - Thrown when any of the specified ranges is invalid.

LexicographicalCompare

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> boolean LexicographicalCompare(TInpIter first1,
                                                                                                       TInpIter last1,
                                                                                                       TInpIter first2,
                                                                                                       TInpIter last2)

Compares two ranges element by element to determine which is the lesser of the two.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

last1 - An input iterator addressing the position one past the final element in the first range to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

last2 - An input iterator addressing the position one past the final element in the second range to be compared.

Returns:

True if the first range is lexicographically less than the second range; otherwise, false.

LexicographicalCompare

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> boolean LexicographicalCompare(TInpIter first1,
                                                                                                       TInpIter last1,
                                                                                                       TInpIter first2,
                                                                                                       TInpIter last2,
                                                                                                       IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element to determine which is the lesser of the two based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

last1 - An input iterator addressing the position one past the final element in the first range to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

last2 - An input iterator addressing the position one past the final element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if the first range is lexicographically less than the second range; otherwise, false.

PLexicographicalCompare

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> boolean PLexicographicalCompare(TInpIter first1,
                                                                                                        TInpIter last1,
                                                                                                        TInpIter first2,
                                                                                                        TInpIter last2)

Parallel LexicographicalCompare: Compares two ranges element by element to determine which is the lesser of the two.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

last1 - An input iterator addressing the position one past the final element in the first range to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

last2 - An input iterator addressing the position one past the final element in the second range to be compared.

Returns:

True if the first range is lexicographically less than the second range; otherwise, false.

PLexicographicalCompare

public static <T,TInpIter extends IInpIter<T,TInpIter>> boolean PLexicographicalCompare(TInpIter first1,
                                                                        TInpIter last1,
                                                                        TInpIter first2,
                                                                        TInpIter last2,
                                                                        IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel LexicographicalCompare: Compares two ranges element by element to determine which is the lesser of the two based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be compared.

last1 - An input iterator addressing the position one past the final element in the first range to be compared.

first2 - An input iterator addressing the position of the first element in the second range to be compared.

last2 - An input iterator addressing the position one past the final element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if the first range is lexicographically less than the second range; otherwise, false.

LexicographicalCompare

public static <T extends java.lang.Comparable<T>> boolean LexicographicalCompare(T[] x,
                                                                 int first1,
                                                                 int last1,
                                                                 T[] y,
                                                                 int first2,
                                                                 int last2)

Compares two ranges element by element to determine which is the lesser of the two.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be compared.

last1 - An integer addressing the position one past the final element in the first range to be compared.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be compared.

last2 - An integer addressing the position one past the final element in the second range to be compared.

Returns:

True if the first range is lexicographically less than the second range; otherwise, false.

LexicographicalCompare

public static <T> boolean LexicographicalCompare(T[] x,
                                 int first1,
                                 int last1,
                                 T[] y,
                                 int first2,
                                 int last2,
                                 IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element to determine which is the lesser of the two based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be compared.

last1 - An integer addressing the position one past the final element in the first range to be compared.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be compared.

last2 - An integer addressing the position one past the final element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if the first range is lexicographically less than the second range; otherwise, false.

PLexicographicalCompare

public static <T extends java.lang.Comparable<T>> boolean PLexicographicalCompare(T[] x,
                                                                  int first1,
                                                                  int last1,
                                                                  T[] y,
                                                                  int first2,
                                                                  int last2)

Parallel LexicographicalCompare: Compares two ranges element by element to determine which is the lesser of the two.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be compared.

last1 - An integer addressing the position one past the final element in the first range to be compared.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be compared.

last2 - An integer addressing the position one past the final element in the second range to be compared.

Returns:

True if the first range is lexicographically less than the second range; otherwise, false.

PLexicographicalCompare

public static <T> boolean PLexicographicalCompare(T[] x,
                                  int first1,
                                  int last1,
                                  T[] y,
                                  int first2,
                                  int last2,
                                  IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel LexicographicalCompare: Compares two ranges element by element to determine which is the lesser of the two based on a binary predicate.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be compared.

last1 - An integer addressing the position one past the final element in the first range to be compared.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be compared.

last2 - An integer addressing the position one past the final element in the second range to be compared.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

True if the first range is lexicographically less than the second range; otherwise, false.

Mismatch

public static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter> Mismatch(TInpIter first1,
                                                                           TInpIter last1,
                                                                           TInpIter first2)

Compares two ranges element by element for equality and locates the first position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

last1 - An input iterator addressing the position one past the final element in the first range to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

Returns:

A pair of input iterators addressing the positions of the mismatch in the two ranges; the first component is an iterator to the position in the first range, and the second component is an iterator to the position in the second range.

Mismatch

public static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter> Mismatch(TInpIter first1,
                                                                           long n,
                                                                           TInpIter first2)

Compares two ranges element by element for equivalence and locates the first position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

n - The number of elements in the specified ranges to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

Returns:

A pair of input iterators addressing the positions of the mismatch in the two ranges; the first component is an iterator to the position in the first range, and the second component is an iterator to the position in the second range.

PMismatch

public static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter> PMismatch(TInpIter first1,
                                                                            TInpIter last1,
                                                                            TInpIter first2)

Parallel Mismatch: Compares two ranges element by element for equality and locates a position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

last1 - An input iterator addressing the position one past the final element in the first range to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

Returns:

A pair of input iterators addressing the positions of the mismatch in the two ranges; the first component is an iterator to the position in the first range, and the second component is an iterator to the position in the second range.

PMismatch

public static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter> PMismatch(TInpIter first1,
                                                                            long n,
                                                                            TInpIter first2)

Parallel Mismatch: Compares two ranges element by element for equivalence and locates a position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

n - The number of elements in the specified ranges to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

Returns:

A pair of input iterators addressing the positions of the mismatch in the two ranges; the first component is an iterator to the position in the first range, and the second component is an iterator to the position in the second range.

Mismatch

public static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter> Mismatch(TInpIter first1,
                                                                           TInpIter last1,
                                                                           TInpIter first2,
                                                                           IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element for equivalence based on a binary predicate and locates the first position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

last1 - An input iterator addressing the position one past the final element in the first range to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

A pair of iterators addressing the positions of the mismatch in the two ranges; the first component is an iterator to the position in the first range, and the second component is an iterator to the position in the second range.

Mismatch

public static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter> Mismatch(TInpIter first1,
                                                                           long n,
                                                                           TInpIter first2,
                                                                           IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element for equivalence based on a binary predicate and locates the first position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

n - The number of elements in the specified ranges to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

A pair of iterators addressing the positions of the mismatch in the two ranges; the first component is an iterator to the position in the first range, and the second component is an iterator to the position in the second range.

PMismatch

public static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter> PMismatch(TInpIter first1,
                                                                            TInpIter last1,
                                                                            TInpIter first2,
                                                                            IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Mismatch: Compares two ranges element by element for equivalence based on a binary predicate and locates a position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

last1 - An input iterator addressing the position one past the final element in the first range to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

A pair of iterators addressing the positions of the mismatch in the two ranges; the first component is an iterator to the position in the first range, and the second component is an iterator to the position in the second range.

PMismatch

public static <T,TInpIter extends IInpIter<T,TInpIter>> Tuple2<TInpIter,TInpIter> PMismatch(TInpIter first1,
                                                                            long n,
                                                                            TInpIter first2,
                                                                            IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Mismatch: Compares two ranges element by element for equivalence based on a binary predicate and locates a position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the specified ranges.

Parameters:

first1 - An input iterator addressing the position of the first element in the first range to be tested.

n - The number of elements in the specified ranges to be tested.

first2 - An input iterator addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

A pair of iterators addressing the positions of the mismatch in the two ranges; the first component is an iterator to the position in the first range, and the second component is an iterator to the position in the second range.

Mismatch

public static <T> Tuple2<java.lang.Integer,java.lang.Integer> Mismatch(T[] x,
                                                       int first1,
                                                       int last1,
                                                       T[] y,
                                                       int first2)

Compares two ranges element by element for equality and locates the first position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be tested.

last1 - An integer addressing the position one past the final element in the first range to be tested.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be tested.

Returns:

A pair of integers addressing the positions of the mismatch in the two ranges; the first integer is the position in the first range, and the second integer is the position in the second range.

PMismatch

public static <T> Tuple2<java.lang.Integer,java.lang.Integer> PMismatch(T[] x,
                                                        int first1,
                                                        int last1,
                                                        T[] y,
                                                        int first2)

Parallel Mismatch: Compares two ranges element by element for equality and locates the first position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be tested.

last1 - An integer addressing the position one past the final element in the first range to be tested.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be tested.

Returns:

A pair of integers addressing the positions of the mismatch in the two ranges; the first integer is the position in the first range, and the second integer is the position in the second range.

Mismatch

public static <T> Tuple2<java.lang.Integer,java.lang.Integer> Mismatch(T[] x,
                                                       int first1,
                                                       int last1,
                                                       T[] y,
                                                       int first2,
                                                       IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two ranges element by element for equivalence based on a binary predicate and locates the first position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be tested.

last1 - An integer addressing the position one past the final element in the first range to be tested.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

A pair of integers addressing the positions of the mismatch in the two ranges; the first integer is the position in the first range, and the second integer is the position in the second range.

PMismatch

public static <T> Tuple2<java.lang.Integer,java.lang.Integer> PMismatch(T[] x,
                                                        int first1,
                                                        int last1,
                                                        T[] y,
                                                        int first2,
                                                        IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel Mismatch: Compares two ranges element by element for equivalence based on a binary predicate and locates the first position where a difference occurs.

Remarks: The ranges to be tested must be valid. The complexity is linear with the size of the ranges.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the first range to be tested.

last1 - An integer addressing the position one past the final element in the first range to be tested.

y - The second specified array.

first2 - An integer addressing the position of the first element in the second range to be tested.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for two elements to be considered equivalent.

Returns:

A pair of integers addressing the positions of the mismatch in the two ranges; the first integer is the position in the first range, and the second integer is the position in the second range.

Copy

public static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter Copy(TInpIter first1,
                                                                                            TInpIter last1,
                                                                                            TOutIter first2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

last1 - An input iterator addressing the position that is one past the final element in the source range.

first2 - An output iterator addressing the position of the first element in the destination range.

Returns:

An output iterator addressing the position that is one past the final element in the destination range; the iterator addresses first2 + (last1 - first1).

Copy

public static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter Copy(TInpIter first1,
                                                                                            long n,
                                                                                            TOutIter first2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

n - The number of elements to copy from the source range.

first2 - An output iterator addressing the position of the first element in the destination range.

Returns:

An output iterator addressing the position that is one past the final element in the destination range; the iterator addresses first2 + n.

Copy

public static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter Copy(TInpIter first1,
                                                                                            TInpIter last1,
                                                                                            TOutIter first2,
                                                                                            IFunc1Arg<T,java.lang.Boolean> pred)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

last1 - An input iterator addressing the position that is one past the final element in the source range.

first2 - An output iterator addressing the position of the first element in the destination range.

pred - A user-defined predicate function that defines the condition to be satisfied by the element in order to be copied.

Returns:

An output iterator addressing the position that is one past the final element in the destination range; the iterator addresses first2 + (last1 - first1).

Copy

public static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter Copy(TInpIter first1,
                                                                                            long n,
                                                                                            TOutIter first2,
                                                                                            IFunc1Arg<T,java.lang.Boolean> pred)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

n - The number of elements to copy from the source range.

first2 - An output iterator addressing the position of the first element in the destination range.

pred - A user-defined predicate function that defines the condition to be satisfied by the element in order to be copied.

Returns:

An output iterator addressing the position that is one past the final element in the destination range; the iterator addresses first2 + n.

PCopy

public static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter PCopy(TInpIter first1,
                                                                                             TInpIter last1,
                                                                                             TOutIter first2)

Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

last1 - An input iterator addressing the position that is one past the final element in the source range.

first2 - An output iterator addressing the position of the first element in the destination range.

Returns:

An output iterator addressing the position that is one past the final element in the destination range; the iterator addresses first2 + (last1 - first1).

PCopy

public static <T,TInpIter extends IInpIter<T,TInpIter>,TOutIter extends IOutIter<T,TOutIter>> TOutIter PCopy(TInpIter first1,
                                                                                             long n,
                                                                                             TOutIter first2)

Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

n - The number of elements to copy from the source range.

first2 - An output iterator addressing the position of the first element in the destination range.

Returns:

An output iterator addressing the position that is one past the final element in the destination range; the iterator addresses first2 + n.

Copy

public static <T> int Copy(T[] x,
           int first1,
           int last1,
           T[] y,
           int first2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

Returns:

An integer addressing the position that is one past the final element in the destination range; the integer addresses first2 + (last1 - first1).

Copy

public static <T> int Copy(T[] x,
           int first1,
           int last1,
           T[] y,
           int first2,
           IFunc1Arg<T,java.lang.Boolean> pred)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

pred - A user-defined predicate function that defines the condition to be satisfied by the element in order to be copied.

Returns:

An integer addressing the position that is one past the final element in the destination range; the integer addresses first2 + (last1 - first1).

PCopy

public static <T> int PCopy(T[] x,
            int first1,
            int last1,
            T[] y,
            int first2)

Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

Returns:

An integer addressing the position that is one past the final element in the destination range; the integer addresses first2 + (last1 - first1).

Copy

public static <T> int Copy(IStreamable<T>[] x,
           int first1,
           int last1,
           IStreamable<T>[] y,
           int first2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

Returns:

An integer addressing the position that is one past the final element in the destination range; the integer addresses first2 + (last1 - first1).

Copy

public static <T> int Copy(IStreamable<T>[] x,
           int first1,
           int last1,
           T[] y,
           int first2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

Returns:

An integer addressing the position that is one past the final element in the destination range; the integer addresses first2 + (last1 - first1).

Copy

public static <T,TInpIter extends IInpIter<T,TInpIter>> int Copy(TInpIter first1,
                                                 TInpIter last1,
                                                 T[] x,
                                                 int first2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

last1 - An input iterator addressing the position that is one past the final element in the source range.

x - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

Returns:

An integer addressing the position that is one past the final element in the destination range; the returned integer addresses first2 + (last1 - first1).

Copy

public static <T,TInpIter extends IInpIter<T,TInpIter>> int Copy(TInpIter first1,
                                                 int n,
                                                 T[] x,
                                                 int first2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

n - The number of elements to copy from the source range.

x - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

Returns:

An integer addressing the position that is one past the final element in the destination range; the returned integer addresses first2 + n.

PCopy

public static <T,TInpIter extends IInpIter<T,TInpIter>> int PCopy(TInpIter first1,
                                                  TInpIter last1,
                                                  T[] x,
                                                  int first2)

Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

last1 - An input iterator addressing the position that is one past the final element in the source range.

x - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

Returns:

An integer addressing the position that is one past the final element in the destination range; the returned integer addresses first2 + (last1 - first1).

PCopy

public static <T,TInpIter extends IInpIter<T,TInpIter>> int PCopy(TInpIter first1,
                                                  int n,
                                                  T[] x,
                                                  int first2)

Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range.

n - The number of elements to copy from the source range.

x - The destination array.

first2 - An integer addressing the position of the first element in the destination range.

Returns:

An integer addressing the position that is one past the final element in the destination range; the returned integer addresses first2 + n.

Copy

public static <T,TOutIter extends IOutIter<T,TOutIter>> TOutIter Copy(T[] x,
                                                      int first1,
                                                      int last1,
                                                      TOutIter first2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TOutIter - The type of iterators in the output range.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

first2 - An output iterator addressing the position of the first element in the destination range.

Returns:

An output iterator addressing the position that is one past the final element in the destination range; the returned iterator addresses first2 + (last1 - first1).

PCopy

public static <T,TOutIter extends IOutIter<T,TOutIter>> TOutIter PCopy(T[] x,
                                                       int first1,
                                                       int last1,
                                                       TOutIter first2)

Parallel Copy: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a forward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TOutIter - The type of iterators in the output range.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

first2 - An output iterator addressing the position of the first element in the destination range.

Returns:

An output iterator addressing the position that is one past the final element in the destination range; the returned iterator addresses first2 + (last1 - first1).

CopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter CopyBackward(TBidIter first1,
                                                              TBidIter last1,
                                                              TBidIter last2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

first1 - A bidirectional iterator addressing the position of the first element in the source range.

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

last2 - A bidirectional iterator addressing the position that is one past the final element in the destination range.

Returns:

A bidirectional iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

CopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter CopyBackward(TBidIter last1,
                                                              long n,
                                                              TBidIter last2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

n - The number of elements to copy from the source range.

last2 - A bidirectional iterator addressing the position that is one past the final element in the destination range.

Returns:

An output iterator addressing the position of the first element in the destination range; the iterator addresses (last2 - n).

CopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter CopyBackward(TBidIter first1,
                                                              TBidIter last1,
                                                              TBidIter last2,
                                                              IFunc1Arg<T,java.lang.Boolean> pred)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

first1 - A bidirectional iterator addressing the position of the first element in the source range.

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

last2 - A bidirectional iterator addressing the position that is one past the final element in the destination range.

pred - A user-defined predicate function that defines the condition to be satisfied by the element in order to be copied.

Returns:

A bidirectional iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

CopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter CopyBackward(TBidIter last1,
                                                              long n,
                                                              TBidIter last2,
                                                              IFunc1Arg<T,java.lang.Boolean> pred)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

n - The number of elements to copy from the source range.

last2 - A bidirectional iterator addressing the position that is one past the final element in the destination range.

pred - A user-defined predicate function that defines the condition to be satisfied by the element in order to be copied.

Returns:

An output iterator addressing the position of the first element in the destination range; the iterator addresses (last2 - n).

PCopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter PCopyBackward(TBidIter first1,
                                                               TBidIter last1,
                                                               TBidIter last2)

Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

first1 - A bidirectional iterator addressing the position of the first element in the source range.

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

last2 - A bidirectional iterator addressing the position that is one past the final element in the destination range.

Returns:

A bidirectional iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

PCopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter PCopyBackward(TBidIter last1,
                                                               long n,
                                                               TBidIter last2)

Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

n - The number of elements to copy from the source range.

last2 - A bidirectional iterator addressing the position that is one past the final element in the destination range.

Returns:

An output iterator addressing the position of the first element in the destination range; the iterator addresses (last2 - n).

CopyBackward

public static <T> int CopyBackward(T[] x,
                   int first1,
                   int last1,
                   T[] y,
                   int last2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The destination array.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

An integer addressing the position of the first element in the destination range; the integer addresses last2 - (last1 - first1).

CopyBackward

public static <T> int CopyBackward(T[] x,
                   int first1,
                   int last1,
                   T[] y,
                   int last2,
                   IFunc1Arg<T,java.lang.Boolean> pred)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The destination array.

last2 - An integer addressing the position that is one past the final element in the destination range.

pred - A user-defined predicate function that defines the condition to be satisfied by the element in order to be copied.

Returns:

An integer addressing the position of the first element in the destination range; the integer addresses last2 - (last1 - first1).

PCopyBackward

public static <T> int PCopyBackward(T[] x,
                    int first1,
                    int last1,
                    T[] y,
                    int last2)

Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The second specified array.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

An integer addressing the position of the first element in the destination range; the integer addresses last2 - (last1 - first1).

CopyBackward

public static <T> int CopyBackward(IStreamable<T>[] x,
                   int first1,
                   int last1,
                   IStreamable<T>[] y,
                   int last2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

y - The destination array.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

An integer addressing the position of the first element in the destination range; the integer addresses last2 - (last1 - first1).

CopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> int CopyBackward(TBidIter first1,
                                                         TBidIter last1,
                                                         T[] x,
                                                         int last2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

first1 - A bidirectional iterator addressing the position of the first element in the source range.

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

x - The destination array.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

An output iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

CopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> int CopyBackward(TBidIter last1,
                                                         int n,
                                                         T[] x,
                                                         int last2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

n - The number of elements to copy from the source range.

x - The destination array.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

An output iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

PCopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> int PCopyBackward(TBidIter first1,
                                                          TBidIter last1,
                                                          T[] x,
                                                          int last2)

Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

first1 - A bidirectional iterator addressing the position of the first element in the source range.

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

x - The destination array.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

An output iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

PCopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> int PCopyBackward(TBidIter last1,
                                                          int n,
                                                          T[] x,
                                                          int last2)

Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

last1 - A bidirectional iterator addressing the position that is one past the final element in the source range.

n - The number of elements to copy from the source range.

x - The destination array.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

An output iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

CopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter CopyBackward(T[] x,
                                                              int first1,
                                                              int last1,
                                                              TBidIter last2)

Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

A bidirectional iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

PCopyBackward

public static <T,TBidIter extends IBidIter<T,TBidIter>> TBidIter PCopyBackward(T[] x,
                                                               int first1,
                                                               int last1,
                                                               TBidIter last2)

Parallel CopyBackward: Assigns the values of elements from a source range to a destination range by iterating through the source sequence of elements in a backward direction.

Remarks: The source range must be valid, and the destination range must have enough space to hold all of the elements being copied.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the specified ranges.

Parameters:

x - The source array.

first1 - An integer addressing the position of the first element in the source range.

last1 - An integer addressing the position that is one past the final element in the source range.

last2 - An integer addressing the position that is one past the final element in the destination range.

Returns:

A bidirectional iterator addressing the position of the first element in the destination range; the iterator addresses last2 - (last1 - first1).

Count

public static <T,TInpIter extends IInpIter<T,TInpIter>> long Count(TInpIter first,
                                                   TInpIter last,
                                                   T value)

Returns the number of elements in a range whose values match a specified value.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be traversed.

last - An input iterator addressing the position one past the final element in the range to be traversed.

value - The value of the elements to be counted.

Returns:

The number of elements in the range [first, last) that have the specified value.

Count

public static <T,TInpIter extends IInpIter<T,TInpIter>> long Count(TInpIter first,
                                                   long n,
                                                   T value)

Returns the number of elements in a range whose values match a specified value.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be traversed.

n - The number of elements in the specified range.

value - The value of the elements to be counted.

Returns:

The number of elements in the range [first, first + n) that have the specified value.

PCount

public static <T,TInpIter extends IInpIter<T,TInpIter>> long PCount(TInpIter first,
                                                    TInpIter last,
                                                    T value)

Parallel Count: Returns the number of elements in a range whose values match a specified value.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be traversed.

last - An input iterator addressing the position one past the final element in the range to be traversed.

value - The value of the elements to be counted.

Returns:

The number of elements in the range [first, last) that have the specified value.

PCount

public static <T,TInpIter extends IInpIter<T,TInpIter>> long PCount(TInpIter first,
                                                    long n,
                                                    T value)

Parallel Count: Returns the number of elements in a range whose values match a specified value.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be traversed.

n - The number of elements in the specified range.

value - The value of the elements to be counted.

Returns:

The number of elements in the range [first, first + n) that have the specified value.

Count

public static <T,TInpIter extends IInpIter<T,TInpIter>> long Count(TInpIter first,
                                                   TInpIter last,
                                                   IPredicate<T> pred)

Returns the number of elements in a range whose values satisfy a specified condition.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be traversed.

last - An input iterator addressing the position one past the final element in the range to be traversed.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for an element to be counted.

Returns:

The number of elements that satisfy the condition specified by the predicate.

Count

public static <T,TInpIter extends IInpIter<T,TInpIter>> long Count(TInpIter first,
                                                   long n,
                                                   IPredicate<T> pred)

Returns the number of elements in a range whose values satisfy a specified condition.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be traversed.

n - The number of elements in the specified range.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for an element to be counted.

Returns:

The number of elements that satisfy the condition specified by the predicate.

PCount

public static <T,TInpIter extends IInpIter<T,TInpIter>> long PCount(TInpIter first,
                                                    TInpIter last,
                                                    IPredicate<T> pred)

Parallel Count: Returns the number of elements in a range whose values satisfy a specified condition.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be traversed.

last - An input iterator addressing the position one past the final element in the range to be traversed.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for an element to be counted.

Returns:

The number of elements that satisfy the condition specified by the predicate.

PCount

public static <T,TInpIter extends IInpIter<T,TInpIter>> long PCount(TInpIter first,
                                                    long n,
                                                    IPredicate<T> pred)

Parallel Count: Returns the number of elements in a range whose values satisfy a specified condition.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be traversed.

n - The number of elements in the specified range.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for an element to be counted.

Returns:

The number of elements that satisfy the condition specified by the predicate.

Count

public static <T> int Count(T[] x,
            int first,
            int last,
            T value)

Returns the number of elements in a range whose values match a specified value.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be traversed.

last - An integer addressing the position one past the final element in the range to be traversed.

value - The value of the elements to be counted.

Returns:

The number of elements in the range [first, last) that have the specified value.

PCount

public static <T> int PCount(T[] x,
             int first,
             int last,
             T value)

Parallel Count: Returns the number of elements in a range whose values match a specified value.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be traversed.

last - An integer addressing the position one past the final element in the range to be traversed.

value - The value of the elements to be counted.

Returns:

The number of elements in the range [first, last) that have the specified value.

Count

public static <T> int Count(T[] x,
            int first,
            int last,
            IPredicate<T> pred)

Returns the number of elements in a range whose values satisfy a specified condition.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be traversed.

last - An integer addressing the position one past the final element in the range to be traversed.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for an element to be counted.

Returns:

The number of elements that satisfy the condition specified by the predicate.

PCount

public static <T> int PCount(T[] x,
             int first,
             int last,
             IPredicate<T> pred)

Parallel Count: Returns the number of elements in a range whose values satisfy a specified condition.

Remarks: The range to be traversed must be valid. The complexity is linear with the size of the range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be traversed.

last - An integer addressing the position one past the final element in the range to be traversed.

pred - A user-defined predicate function object that defines the condition to be satisfied in order for an element to be counted.

Returns:

The number of elements that satisfy the condition specified by the predicate.

Min

public static <T extends java.lang.Comparable<T>> T Min(T x,
                                        T y)

Compares two objects and returns the lesser of the two.

Type Parameters:

T - The type of elements to be compared.

Parameters:

x - The first of the two objects being compared.

y - The second of the two objects being compared.

Returns:

The lesser of the two objects unless neither is lesser, in which case it returns the first of the two objects.

Min

public static <T> T Min(T x,
        T y,
        IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two objects and returns the lesser of the two, where the ordering criterion is specified by a binary predicate.

Type Parameters:

T - The type of elements to be compared.

Parameters:

x - The first of the two objects being compared.

y - The second of the two objects being compared.

pred - A binary predicate used to compare the two objects.

Returns:

The lesser of the two objects unless neither is lesser, in which case it returns the first of the two objects.

Max

public static <T extends java.lang.Comparable<T>> T Max(T x,
                                        T y)

Compares two objects and returns the larger of the two.

Type Parameters:

T - The type of elements to be compared.

Parameters:

x - The first of the two objects being compared.

y - The second of the two objects being compared.

Returns:

The greater of the two objects unless neither is greater, in which case it returns the first of the two objects.

Max

public static <T> T Max(T x,
        T y,
        IFunc2Arg<T,T,java.lang.Boolean> pred)

Compares two objects and returns the larger of the two, where the ordering criterion is specified by a binary predicate.

Type Parameters:

T - The type of elements to be compared.

Parameters:

x - The first of the two objects being compared.

y - The second of the two objects being compared.

pred - A binary predicate used to compare the two objects.

Returns:

The greater of the two objects unless neither is greater, in which case it returns the first of the two objects.

MinElement

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter MinElement(TInpIter first,
                                                                                            TInpIter last)

Finds the first occurrence of the smallest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

last - An input iterator addressing the position one past the final element in the range to be searched.

Returns:

An input iterator addressing the position of the first occurrence of the smallest element in the specified range.

MinElement

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter MinElement(TInpIter first,
                                                                                            long n)

Finds the first occurrence of the smallest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: n + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

n - The number of elements in the specified range.

Returns:

An input iterator addressing the position of the first occurrence of the smallest element in the specified range.

PMinElement

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter PMinElement(TInpIter first,
                                                                                             TInpIter last)

Parallel MinElement: Finds the first occurrence of the smallest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

last - An input iterator addressing the position one past the final element in the range to be searched.

Returns:

An input iterator addressing the position of the first occurrence of the smallest element in the specified range.

PMinElement

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter PMinElement(TInpIter first,
                                                                                             long n)

Parallel MinElement: Finds the first occurrence of the smallest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: n + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

n - The number of elements in the specified range.

Returns:

An input iterator addressing the position of the first occurrence of the smallest element in the specified range.

MinElement

public static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter MinElement(TInpIter first,
                                                            TInpIter last,
                                                            IFunc2Arg<T,T,java.lang.Boolean> pred)

Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

last - An input iterator addressing the position one past the final element in the range to be searched.

pred - A user-defined predicate function object that defines the sense in which one element is lesser than another.

Returns:

An input iterator addressing the position of the first occurrence of the smallest element in the specified range.

MinElement

public static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter MinElement(TInpIter first,
                                                            long n,
                                                            IFunc2Arg<T,T,java.lang.Boolean> pred)

Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: n + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

n - The number of elements in the specified range.

pred - A user-defined predicate function object that defines the sense in which one element is lesser than another.

Returns:

An input iterator addressing the position of the first occurrence of the smallest element in the specified range.

PMinElement

public static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter PMinElement(TInpIter first,
                                                             TInpIter last,
                                                             IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel MinElement: Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

last - An input iterator addressing the position one past the final element in the range to be searched.

pred - A user-defined predicate function object that defines the sense in which one element is lesser than another.

Returns:

An input iterator addressing the position of the first occurrence of the smallest element in the specified range.

PMinElement

public static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter PMinElement(TInpIter first,
                                                             long n,
                                                             IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel MinElement: Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: n + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

n - The number of elements in the specified range.

pred - A user-defined predicate function object that defines the sense in which one element is lesser than another.

Returns:

An input iterator addressing the position of the first occurrence of the smallest element in the specified range.

MinElement

public static <T extends java.lang.Comparable<T>> int MinElement(T[] x,
                                                 int first,
                                                 int last)

Finds the first occurrence of the smallest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be searched.

last - An integer addressing the position one past the final element in the range to be searched.

Returns:

An integer addressing the position of the first occurrence of the smallest element in the specified range.

PMinElement

public static <T extends java.lang.Comparable<T>> int PMinElement(T[] x,
                                                  int first,
                                                  int last)

Parallel MinElement: Finds the first occurrence of the smallest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be searched.

last - An integer addressing the position one past the final element in the range to be searched.

Returns:

An integer addressing the position of the first occurrence of the smallest element in the specified range.

MinElement

public static <T> int MinElement(T[] x,
                 int first,
                 int last,
                 IFunc2Arg<T,T,java.lang.Boolean> pred)

Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be searched.

last - An integer addressing the position one past the final element in the range to be searched.

pred - A user-defined predicate function object that defines the sense in which one element is lesser than another.

Returns:

An integer addressing the position of the first occurrence of the smallest element in the specified range.

PMinElement

public static <T> int PMinElement(T[] x,
                  int first,
                  int last,
                  IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel MinElement: Finds the first occurrence of the smallest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be searched.

last - An integer addressing the position one past the final element in the range to be searched.

pred - A user-defined predicate function object that defines the sense in which one element is lesser than another.

Returns:

An integer addressing the position of the first occurrence of the smallest element in the specified range.

MaxElement

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter MaxElement(TInpIter first,
                                                                                            TInpIter last)

Finds the first occurrence of the largest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

last - An input iterator addressing the position one past the final element in the range to be searched.

Returns:

An input iterator addressing the position of the first occurrence of the largest element in the specified range.

MaxElement

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter MaxElement(TInpIter first,
                                                                                            long n)

Finds the first occurrence of the largest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: n + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

n - The number of elements in the specified range.

Returns:

An input iterator addressing the position of the first occurrence of the largest element in the specified range.

PMaxElement

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter PMaxElement(TInpIter first,
                                                                                             TInpIter last)

Parallel MaxElement: Finds the first occurrence of the largest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

last - An input iterator addressing the position one past the final element in the range to be searched.

Returns:

An input iterator addressing the position of the first occurrence of the largest element in the specified range.

PMaxElement

public static <T extends java.lang.Comparable<T>,TInpIter extends IInpIter<T,TInpIter>> TInpIter PMaxElement(TInpIter first,
                                                                                             long n)

Parallel MaxElement: Finds the first occurrence of the largest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: n + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

n - The number of elements in the specified range.

Returns:

An input iterator addressing the position of the first occurrence of the largest element in the specified range.

MaxElement

public static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter MaxElement(TInpIter first,
                                                            TInpIter last,
                                                            IFunc2Arg<T,T,java.lang.Boolean> pred)

Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

last - An input iterator addressing the position one past the final element in the range to be searched.

pred - A user-defined predicate function object that defines the sense in which one element is greater than another.

Returns:

An input iterator addressing the position of the first occurrence of the largest element in the specified range.

MaxElement

public static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter MaxElement(TInpIter first,
                                                            long n,
                                                            IFunc2Arg<T,T,java.lang.Boolean> pred)

Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: n + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

n - The number of elements in the specified range.

pred - A user-defined predicate function object that defines the sense in which one element is greater than another.

Returns:

An input iterator addressing the position of the first occurrence of the largest element in the specified range.

PMaxElement

public static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter PMaxElement(TInpIter first,
                                                             TInpIter last,
                                                             IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel MaxElement: Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

last - An input iterator addressing the position one past the final element in the range to be searched.

pred - A user-defined predicate function object that defines the sense in which one element is greater than another.

Returns:

An input iterator addressing the position of the first occurrence of the largest element in the specified range.

PMaxElement

public static <T,TInpIter extends IInpIter<T,TInpIter>> TInpIter PMaxElement(TInpIter first,
                                                             long n,
                                                             IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel MaxElement: Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: n + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

TInpIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be searched.

n - The number of elements in the specified range.

pred - A user-defined predicate function object that defines the sense in which one element is greater than another.

Returns:

An input iterator addressing the position of the first occurrence of the largest element in the specified range.

MaxElement

public static <T extends java.lang.Comparable<T>> int MaxElement(T[] x,
                                                 int first,
                                                 int last)

Finds the first occurrence of the largest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be searched.

last - An integer addressing the position one past the final element in the range to be searched.

Returns:

An integer addressing the position of the first occurrence of the largest element in the specified range.

PMaxElement

public static <T extends java.lang.Comparable<T>> int PMaxElement(T[] x,
                                                  int first,
                                                  int last)

Parallel MaxElement: Finds the first occurrence of the largest element in a specified range.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be searched.

last - An integer addressing the position one past the final element in the range to be searched.

Returns:

An integer addressing the position of the first occurrence of the largest element in the specified range.

MaxElement

public static <T> int MaxElement(T[] x,
                 int first,
                 int last,
                 IFunc2Arg<T,T,java.lang.Boolean> pred)

Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be searched.

last - An integer addressing the position one past the final element in the range to be searched.

pred - A user-defined predicate function object that defines the sense in which one element is greater than another.

Returns:

An integer addressing the position of the first occurrence of the largest element in the specified range.

PMaxElement

public static <T> int PMaxElement(T[] x,
                  int first,
                  int last,
                  IFunc2Arg<T,T,java.lang.Boolean> pred)

Parallel MaxElement: Finds the first occurrence of the largest element in a specified range, where the ordering criterion is specified by a binary predicate.

Remarks: The referenced range must be valid. The complexity is linear: (last - first) + 1 comparisons are required for a nonempty range.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be searched.

last - An integer addressing the position one past the final element in the range to be searched.

pred - A user-defined predicate function object that defines the sense in which one element is greater than another.

Returns:

An integer addressing the position of the first occurrence of the largest element in the specified range.

Swap

public static <T> void Swap(T[] x,
            int idx1,
            int idx2)

Exchanges the values of the elements between two array elements, assigning the contents of the first object to the second object and the contents of the second to the first.

Type Parameters:

T - The type of elements to be swapped.

Parameters:

x - The specified array.

idx1 - The index of the first object to have its elements exchanged.

idx2 - The index of the second object to have its elements exchanged.

IterSwap

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void IterSwap(TFwdIter iter1,
                                                      TFwdIter iter2)

Exchanges the values (contents) between two iterators.

Type Parameters:

T - The type of contents of the specified iterators.

TFwdIter - The type of iterators that will exchange their values.

Parameters:

iter1 - The first iterator to have its content exchanged.

iter2 - The second iterator to have its content exchanged.

SwapRanges

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> TFwdIter SwapRanges(TFwdIter first1,
                                                            TFwdIter last1,
                                                            TFwdIter first2)

Exchanges the contents of two ranges of equal size.

Remarks: The ranges referenced must be valid. The complexity is linear with (last1 – first1) swaps performed.

Type Parameters:

T - The type of contents of the specified iterators.

TFwdIter - The type of iterators that will exchange their values.

Parameters:

first1 - A forward iterator pointing to the first position of the first range whose elements are to be exchanged.

last1 - A forward iterator pointing to one past the final position of the first range whose elements are to be exchanged.

first2 - A forward iterator pointing to the first position of the second range whose elements are to be exchanged.

Returns:

A forward iterator pointing to one past the final position of the second range whose elements are to be exchanged.

SwapRanges

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> TFwdIter SwapRanges(TFwdIter first1,
                                                            long n,
                                                            TFwdIter first2)

Exchanges the contents of two ranges of equal size.

Remarks: The ranges referenced must be valid. The complexity is linear with n swaps performed.

Type Parameters:

T - The type of contents of the specified iterators.

TFwdIter - The type of iterators that will exchange their values.

Parameters:

first1 - A forward iterator pointing to the first position of the first range whose elements are to be exchanged.

n - The number of elements in the specified ranges whose elements are to be exchanged.

first2 - A forward iterator pointing to the first position of the second range whose elements are to be exchanged.

Returns:

A forward iterator pointing to one past the final position of the second range whose elements are to be exchanged.

PSwapRanges

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> TFwdIter PSwapRanges(TFwdIter first1,
                                                             TFwdIter last1,
                                                             TFwdIter first2)

Parallel SwapRanges: Exchanges the contents of two ranges of equal size.

Remarks: The ranges referenced must be valid. The complexity is linear with (last1 – first1) swaps performed.

Type Parameters:

T - The type of contents of the specified iterators.

TFwdIter - The type of iterators that will exchange their values.

Parameters:

first1 - A forward iterator pointing to the first position of the first range whose elements are to be exchanged.

last1 - A forward iterator pointing to one past the final position of the first range whose elements are to be exchanged.

first2 - A forward iterator pointing to the first position of the second range whose elements are to be exchanged.

Returns:

A forward iterator pointing to one past the final position of the second range whose elements are to be exchanged.

PSwapRanges

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> TFwdIter PSwapRanges(TFwdIter first1,
                                                             long n,
                                                             TFwdIter first2)

Parallel SwapRanges: Exchanges the contents of two ranges of equal size.

Remarks: The ranges referenced must be valid. The complexity is linear with n swaps performed.

Type Parameters:

T - The type of contents of the specified iterators.

TFwdIter - The type of iterators that will exchange their values.

Parameters:

first1 - A forward iterator pointing to the first position of the first range whose elements are to be exchanged.

n - The number of elements in the specified ranges whose elements are to be exchanged.

first2 - A forward iterator pointing to the first position of the second range whose elements are to be exchanged.

Returns:

A forward iterator pointing to one past the final position of the second range whose elements are to be exchanged.

SwapRanges

public static <T> int SwapRanges(T[] x,
                 int first1,
                 int last1,
                 T[] y,
                 int first2)

Exchanges the contents of two ranges of equal size.

Remarks: The ranges referenced must be valid. The complexity is linear with (last1 – first1) swaps performed.

Type Parameters:

T - The type of contents of the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the first position of the first range whose elements are to be exchanged.

last1 - An integer addressing one past the final position of the first range whose elements are to be exchanged.

y - The second specified array.

first2 - An integer addressing the first position of the second range whose elements are to be exchanged.

Returns:

An integer addressing one past the final position of the second range whose elements are to be exchanged.

PSwapRanges

public static <T> int PSwapRanges(T[] x,
                  int first1,
                  int last1,
                  T[] y,
                  int first2)

Parallel SwapRanges: Exchanges the contents of two ranges of equal size.

Remarks: The ranges referenced must be valid. The complexity is linear with (last1 – first1) swaps performed.

Type Parameters:

T - The type of contents of the specified ranges.

Parameters:

x - The first specified array.

first1 - An integer addressing the first position of the first range whose elements are to be exchanged.

last1 - An integer addressing one past the final position of the first range whose elements are to be exchanged.

y - The second specified array.

first2 - An integer addressing the first position of the second range whose elements are to be exchanged.

Returns:

An integer addressing one past the final position of the second range whose elements are to be exchanged.

ForEach

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void ForEach(TFwdIter first,
                                                     TFwdIter last,
                                                     IAction1Arg<TFwdIter> func)

Applies a specified function object in a forward order to each iterator in a range.

Remarks: The referenced range must be valid. The complexity is linear with (last - first) iterations.

Type Parameters:

T - The type of elements in the specified range.

TFwdIter - The type of iterators in the specified range.

Parameters:

first - A forward iterator addressing the position of the first element in the range to be operated on.

last - A forward iterator addressing the position one past the final element in the range to be operated on.

func - A user-defined function object that is applied to each iterator in the range.

ForEach

public static <T,TFwdIter extends IInpIter<T,TFwdIter>> void ForEach(TFwdIter first,
                                                     long n,
                                                     IAction1Arg<TFwdIter> func)

Applies a specified function object in a forward order to each iterator in a range.

Remarks: The referenced range must be valid. The complexity is linear with n iterations.

Type Parameters:

T - The type of elements in the specified range.

TFwdIter - The type of iterators in the specified range.

Parameters:

first - A forward iterator addressing the position of the first element in the range to be operated on.

n - The number of elements in the specified range.

func - A user-defined function object that is applied to each iterator in the range.

PForEach

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void PForEach(TFwdIter first,
                                                      TFwdIter last,
                                                      IAction1Arg<TFwdIter> func)

Parallel ForEach: Applies a specified function object in a forward order to each iterator in a range.

Remarks: The referenced range must be valid. The complexity is linear with (last - first) iterations.

Type Parameters:

T - The type of elements in the specified range.

TFwdIter - The type of iterators in the specified range.

Parameters:

first - A forward iterator addressing the position of the first element in the range to be operated on.

last - A forward iterator addressing the position one past the final element in the range to be operated on.

func - A user-defined function object that is applied to each iterator in the range.

PForEach

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void PForEach(TFwdIter first,
                                                      long n,
                                                      IAction1Arg<TFwdIter> func)

Parallel ForEach: Applies a specified function object in a forward order to each iterator in a range.

Remarks: The referenced range must be valid. The complexity is linear with n iterations.

Type Parameters:

T - The type of elements in the specified range.

TFwdIter - The type of iterators in the specified range.

Parameters:

first - A forward iterator addressing the position of the first element in the range to be operated on.

n - The number of elements in the specified range.

func - A user-defined function object that is applied to each iterator in the range.

ForEach

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void ForEach(TFwdIter first,
                                                     TFwdIter last,
                                                     IPredicate<T> pred,
                                                     IAction1Arg<TFwdIter> func)

Applies a specified function object in a forward order to all iterators in a range that satisfy a predicate.

Remarks: The referenced range must be valid. The complexity is linear with at most (last - first) comparisons.

Type Parameters:

T - The type of elements in the specified range.

TFwdIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be operated on.

last - An input iterator addressing the position one past the final element in the range to be operated on.

pred - A user-defined predicate that defines the condition to be satisfied by an iterator in order to apply the function object.

func - A user-defined function object that is applied to all iterators in the range that satisfy a predicate.

ForEach

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void ForEach(TFwdIter first,
                                                     long n,
                                                     IPredicate<T> pred,
                                                     IAction1Arg<TFwdIter> func)

Applies a specified function object in a forward order to all iterators in a range that satisfy a predicate.

Remarks: The referenced range must be valid. The complexity is linear with at most n comparisons.

Type Parameters:

T - The type of elements in the specified range.

TFwdIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be operated on.

n - The number of elements in the specified range.

pred - A user-defined predicate that defines the condition to be satisfied by an iterator in order to apply the function object.

func - A user-defined function object that is applied to all iterators in the range that satisfy a predicate.

PForEach

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void PForEach(TFwdIter first,
                                                      TFwdIter last,
                                                      IPredicate<T> pred,
                                                      IAction1Arg<TFwdIter> func)

Parallel ForEach: Applies a specified function object in a forward order to all iterators in a range that satisfy a predicate.

Remarks: The referenced range must be valid. The complexity is linear with at most (last - first) comparisons.

Type Parameters:

T - The type of elements in the specified range.

TFwdIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be operated on.

last - An input iterator addressing the position one past the final element in the range to be operated on.

pred - A user-defined predicate that defines the condition to be satisfied by an iterator in order to apply the function object.

func - A user-defined function object that is applied to all iterators in the range that satisfy a predicate.

PForEach

public static <T,TFwdIter extends IFwdIter<T,TFwdIter>> void PForEach(TFwdIter first,
                                                      long n,
                                                      IPredicate<T> pred,
                                                      IAction1Arg<TFwdIter> func)

Parallel ForEach: Applies a specified function object in a forward order to all iterators in a range that satisfy a predicate.

Remarks: The referenced range must be valid. The complexity is linear with at most n comparisons.

Type Parameters:

T - The type of elements in the specified range.

TFwdIter - The type of iterators in the specified range.

Parameters:

first - An input iterator addressing the position of the first element in the range to be operated on.

n - The number of elements in the specified range.

pred - A user-defined predicate that defines the condition to be satisfied by an iterator in order to apply the function object.

func - A user-defined function object that is applied to all iterators in the range that satisfy a predicate.

ForEach

public static <T> void ForEach(T[] x,
               int first,
               int last,
               IAction2Arg<T[],java.lang.Integer> func)

Applies a specified function object in a forward order to each element in a range.

Remarks: The referenced range must be valid. The complexity is linear with (last - first) iterations.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be operated on.

last - An integer addressing the position one past the final element in the range to be operated on.

func - A user-defined function object that is applied to each element in the range.

PForEach

public static <T> void PForEach(T[] x,
                int first,
                int last,
                IAction2Arg<T[],java.lang.Integer> func)

Parallel ForEach: Applies a specified function object in a forward order to each element in a range.

Remarks: The referenced range must be valid. The complexity is linear with (last - first) iterations.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be operated on.

last - An integer addressing the position one past the final element in the range to be operated on.

func - A user-defined function object that is applied to each element in the range.

ForEach

public static <T> void ForEach(T[] x,
               int first,
               int last,
               IPredicate<T> pred,
               IAction2Arg<T[],java.lang.Integer> func)

Applies a specified function object in a forward order to all elements in a range that satisfy a predicate.

Remarks: The referenced range must be valid. The complexity is linear with at most (last - first) comparisons.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be operated on.

last - An integer addressing the position one past the final element in the range to be operated on.

pred - A user-defined predicate that defines the condition to be satisfied by an element in order to apply the function object.

func - A user-defined function object that is applied to all elements in the range that satisfy a predicate.

PForEach

public static <T> void PForEach(T[] x,
                int first,
                int last,
                IPredicate<T> pred,
                IAction2Arg<T[],java.lang.Integer> func)

Parallel ForEach: Applies a specified function object in a forward order to all elements in a range that satisfy a predicate.

Remarks: The referenced range must be valid. The complexity is linear with at most (last - first) comparisons.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

x - The specified array.

first - An integer addressing the position of the first element in the range to be operated on.

last - An integer addressing the position one past the final element in the range to be operated on.

pred - A user-defined predicate that defines the condition to be satisfied by an element in order to apply the function object.

func - A user-defined function object that is applied to all elements in the range that satisfy a predicate.

Transform

public static <T,TInpIter extends IInpIter<T,TInpIter>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter Transform(TInpIter first,
                                                                                                               TInpIter last,
                                                                                                               TOutIter result,
                                                                                                               IFunc1Arg<T,TResult> func)

Applies a specified function to each element in a source range and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TResult - The type of elements in the output range.

TOutIter - The type of iterators in the output range.

Parameters:

first - An input iterator addressing the position of the first element in the source range to be operated on.

last - An input iterator addressing the position one past the final element in the source range to be operated on.

result - An output iterator addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied in a forward order to the source range.

Returns:

An output iterator addressing the position one past the final element in the destination range.

Transform

public static <T,TInpIter extends IInpIter<T,TInpIter>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter Transform(TInpIter first,
                                                                                                               long n,
                                                                                                               TOutIter result,
                                                                                                               IFunc1Arg<T,TResult> func)

Applies a specified function to each element in a source range and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TResult - The type of elements in the output range.

TOutIter - The type of iterators in the output range.

Parameters:

first - An input iterator addressing the position of the first element in the source range to be operated on.

n - The number of elements in the specified ranges to be operated on.

result - An output iterator addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied in a forward order to the source range.

Returns:

An output iterator addressing the position one past the final element in the destination range.

PTransform

public static <T,TInpIter extends IInpIter<T,TInpIter>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter PTransform(TInpIter first,
                                                                                                                TInpIter last,
                                                                                                                TOutIter result,
                                                                                                                IFunc1Arg<T,TResult> func)

Parallel Transform: Applies a specified function to each element in a source range and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TResult - The type of elements in the output range.

TOutIter - The type of iterators in the output range.

Parameters:

first - An input iterator addressing the position of the first element in the source range to be operated on.

last - An input iterator addressing the position one past the final element in the source range to be operated on.

result - An output iterator addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied in a forward order to the source range.

Returns:

An output iterator addressing the position one past the final element in the destination range.

PTransform

public static <T,TInpIter extends IInpIter<T,TInpIter>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter PTransform(TInpIter first1,
                                                                                                                long n,
                                                                                                                TOutIter first2,
                                                                                                                IFunc1Arg<T,TResult> func)

Parallel Transform: Applies a specified function to each element in a source range and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T - The type of elements in the specified ranges.

TInpIter - The type of iterators in the input range.

TResult - The type of elements in the output range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the source range to be operated on.

n - The number of elements in the specified ranges to be operated on.

first2 - An output iterator addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied in a forward order to the source range.

Returns:

An output iterator addressing the position one past the final element in the destination range.

Transform

public static <T1,TInpIter1 extends IInpIter<T1,TInpIter1>,T2,TInpIter2 extends IInpIter<T2,TInpIter2>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter Transform(TInpIter1 first1,
                                                                                                                                                               TInpIter1 last1,
                                                                                                                                                               TInpIter2 first2,
                                                                                                                                                               TOutIter result,
                                                                                                                                                               IFunc2Arg<T1,T2,TResult> func)

Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T1 - The type of elements in the first input range.

TInpIter1 - The type of iterators in the first input range.

T2 - The type of elements in the second input range.

TInpIter2 - The type of iterators in the second input range.

TResult - The type of elements in the output range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the first source range to be operated on.

last1 - An input iterator addressing the position one past the final element in the first source range to be operated on.

first2 - An input iterator addressing the position of the first element in the second source range to be operated on.

result - An output iterator addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied to each pair of elements from the source ranges.

Returns:

An output iterator addressing the position one past the final element in the destination range.

Transform

public static <T1,TInpIter1 extends IInpIter<T1,TInpIter1>,T2,TInpIter2 extends IInpIter<T2,TInpIter2>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter Transform(TInpIter1 first1,
                                                                                                                                                               long n,
                                                                                                                                                               TInpIter2 first2,
                                                                                                                                                               TOutIter result,
                                                                                                                                                               IFunc2Arg<T1,T2,TResult> func)

Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T1 - The type of elements in the first input range.

TInpIter1 - The type of iterators in the first input range.

T2 - The type of elements in the second input range.

TInpIter2 - The type of iterators in the second input range.

TResult - The type of elements in the output range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the first source range to be operated on.

n - The number of elements in the specified ranges to be operated on.

first2 - An input iterator addressing the position of the first element in the second source range to be operated on.

result - An output iterator addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied to each pair of elements from the source ranges.

Returns:

An output iterator addressing the position one past the final element in the destination range.

PTransform

public static <T1,TInpIter1 extends IInpIter<T1,TInpIter1>,T2,TInpIter2 extends IInpIter<T2,TInpIter2>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter PTransform(TInpIter1 first1,
                                                                                                                                                                TInpIter1 last1,
                                                                                                                                                                TInpIter2 first2,
                                                                                                                                                                TOutIter result,
                                                                                                                                                                IFunc2Arg<T1,T2,TResult> func)

Parallel Transform: Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T1 - The type of elements in the first input range.

TInpIter1 - The type of iterators in the first input range.

T2 - The type of elements in the second input range.

TInpIter2 - The type of iterators in the second input range.

TResult - The type of elements in the output range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the first source range to be operated on.

last1 - An input iterator addressing the position one past the final element in the first source range to be operated on.

first2 - An input iterator addressing the position of the first element in the second source range to be operated on.

result - An output iterator addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied to each pair of elements from the source ranges.

Returns:

An output iterator addressing the position one past the final element in the destination range.

PTransform

public static <T1,TInpIter1 extends IInpIter<T1,TInpIter1>,T2,TInpIter2 extends IInpIter<T2,TInpIter2>,TResult,TOutIter extends IOutIter<TResult,TOutIter>> TOutIter PTransform(TInpIter1 first1,
                                                                                                                                                                long n,
                                                                                                                                                                TInpIter2 first2,
                                                                                                                                                                TOutIter result,
                                                                                                                                                                IFunc2Arg<T1,T2,TResult> func)

Parallel Transform: Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source ranges. The complexity is linear with the number of iterations.

Type Parameters:

T1 - The type of elements in the first input range.

TInpIter1 - The type of iterators in the first input range.

T2 - The type of elements in the second input range.

TInpIter2 - The type of iterators in the second input range.

TResult - The type of elements in the output range.

TOutIter - The type of iterators in the output range.

Parameters:

first1 - An input iterator addressing the position of the first element in the first source range to be operated on.

n - The number of elements in the specified ranges to be operated on.

first2 - An input iterator addressing the position of the first element in the second source range to be operated on.

result - An output iterator addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied to each pair of elements from the source ranges.

Returns:

An output iterator addressing the position one past the final element in the destination range.

Transform

public static <T,TResult> int Transform(T[] x,
                        int first,
                        int last,
                        TResult[] y,
                        int result,
                        IFunc1Arg<T,TResult> func)

Applies a specified function to each element in a source range and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T - The type of elements in the input range.

TResult - The type of elements in the output range.

Parameters:

x - The specified source range.

first - An integer addressing the position of the first element in the source range to be operated on.

last - An integer addressing the position one past the final element in the source range to be operated on.

y - The specified destination range.

result - An integer addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied in a forward order to the source range.

Returns:

An integer addressing the position one past the final element in the destination range.

PTransform

public static <T,TResult> int PTransform(T[] x,
                         int first1,
                         int last1,
                         TResult[] y,
                         int first2,
                         IFunc1Arg<T,TResult> func)

Parallel Transform: Applies a specified function to each element in a source range and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source range. The complexity is linear with the number of iterations.

Type Parameters:

T - The type of elements in the input range.

TResult - The type of elements in the output range.

Parameters:

x - The specified source range.

first1 - An integer addressing the position of the first element in the source range to be operated on.

last1 - An integer addressing the position one past the final element in the source range to be operated on.

y - The specified destination range.

first2 - An integer addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied in a forward order to the source range.

Returns:

An integer addressing the position one past the final element in the destination range.

Transform

public static <T1,T2,TResult> int Transform(T1[] x,
                            int first1,
                            int last1,
                            T2[] y,
                            int first2,
                            TResult[] z,
                            int result,
                            IFunc2Arg<T1,T2,TResult> func)

Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source ranges. The complexity is linear with the number of iterations.

Type Parameters:

T1 - The type of elements in the first input range.

T2 - The type of elements in the second input range.

TResult - The type of elements in the output range.

Parameters:

x - The first specified source range.

first1 - An integer addressing the position of the first element in the first source range to be operated on.

last1 - An integer addressing the position one past the final element in the first source range to be operated on.

y - The second specified source range.

first2 - An integer addressing the position of the first element in the second source range to be operated on.

z - The specified destination range.

result - An integer addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied to each pair of elements from the source ranges.

Returns:

An integer addressing the position one past the final element in the destination range.

PTransform

public static <T1,T2,TResult> int PTransform(T1[] x,
                             int first1,
                             int last1,
                             T2[] y,
                             int first2,
                             TResult[] z,
                             int result,
                             IFunc2Arg<T1,T2,TResult> func)

Parallel Transform: Applies a specified function to a pair of elements from two source ranges and copies the return values of the function into a destination range.

Remarks: The ranges referenced must be valid. The destination range must be large enough to contain the transformed source ranges. The complexity is linear with the number of iterations.

Type Parameters:

T1 - The type of elements in the first input range.

T2 - The type of elements in the second input range.

TResult - The type of elements in the output range.

Parameters:

x - The first specified source range.

first1 - An integer addressing the position of the first element in the first source range to be operated on.

last1 - An integer addressing the position one past the final element in the first source range to be operated on.

y - The second specified source range.

first2 - An integer addressing the position of the first element in the second source range to be operated on.

z - The specified destination range.

result - An integer addressing the position of the first element in the destination range.

func - A user-defined unary function that is applied to each pair of elements from the source ranges.

Returns:

An integer addressing the position one past the final element in the destination range.

PProcess

public static <T> void PProcess(T[] data,
                int first,
                int last,
                IAction3Arg<T[],java.lang.Integer,java.lang.Integer> func)

Parallel Process: Applies a specified function to each element in current container.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

data - The specified source range.

first - An integer addressing the position of the first element in the source range to be operated on.

last - An integer addressing the position one past the final element in the source range to be operated on.

func - A user-defined unary function that is applied to the source range.

ToString

public static <T,TBidIter extends IBidIter<T,TBidIter>> java.lang.String ToString(TBidIter first,
                                                                  TBidIter last)

Returns a string that represents the elements of the specified range.

Remarks: If the specified range has a large number of elements, this function may throw an exception.

Type Parameters:

T - The type of elements in the specified range.

TBidIter - The type of iterators in the input range.

Parameters:

first - An iterator addressing the position of the first element in the range.

last - An iterator addressing the position one past the final element in the range.

Returns:

A string that represents the elements from the specified range.

ToStream

public static <T,TBidIter extends IBidIter<T,TBidIter>> void ToStream(TBidIter first,
                                                      TBidIter last,
                                                      java.io.PrintStream sw)

Writes the elements of the specified range to the specified stream.

Remarks: If the specified range has a large number of elements, this function may throw an exception.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the input range.

Parameters:

first - An iterator addressing the position of the first element in the range.

last - An iterator addressing the position one past the final element in the range.

sw - A PrintStream object to write to.

ToStream

public static <T,TBidIter extends IBidIter<T,TBidIter>> void ToStream(TBidIter first,
                                                      long n,
                                                      java.io.PrintStream sw)

Writes the elements of the specified range to the specified stream.

Remarks: If the specified range has a large number of elements, this function may throw an exception.

Type Parameters:

T - The type of elements in the specified ranges.

TBidIter - The type of iterators in the input range.

Parameters:

first - An iterator addressing the position of the first element in the range.

n - The number of elements in the specified range.

sw - A PrintStream object to write to.

ToString

public static <T> java.lang.String ToString(T[] data,
                            int first,
                            int last)

Returns a string that represents the elements of the specified range.

Remarks: If the specified range has a large number of elements, this function may throw an exception.

Type Parameters:

T - The type of elements in the specified range.

Parameters:

data - The specified source range.

first - An integer addressing the position of the first element in the source range to be operated on.

last - An integer addressing the position one past the final element in the source range to be operated on.

Returns:

A string that represents the elements from the specified range.

ToStream

public static <T> void ToStream(T[] data,
                int first,
                int last,
                java.io.PrintStream sw)

Writes the elements of the specified range to the specified stream.

Remarks: If the specified range has a large number of elements, this function may throw an exception.

Type Parameters:

T - The type of elements in the specified ranges.

Parameters:

data - The specified source range.

first - An integer addressing the position of the first element in the source range to be operated on.

last - An integer addressing the position one past the final element in the source range to be operated on.

sw - A PrintStream object to write to.

Partition

public static Tuple2<java.lang.Integer,java.lang.Integer> Partition(int size)

Partitions the range [0, size) into blocks of PARTITION_SIZE.

Parameters:

size - The specified size.

Returns:

A pair that contains the number of blocks in the first element and the size of the last block (the remainder).

Partition

public static Tuple2<java.lang.Integer,java.lang.Integer> Partition(int size,
                                                    int partitionSize)

Partitions the range [0, size) into blocks of partitionSize.

Parameters:

size - The specified size.

partitionSize - The specified partition size.

Returns:

A pair that contains the number of blocks in the first element and the size of the last block (the remainder).

Partition

public static Tuple2<java.lang.Long,java.lang.Integer> Partition(long size)

Partitions the range [0, size) into blocks of PARTITION_SIZE.

Parameters:

size - The specified size.

Returns:

A pair that contains the number of blocks in the first element and the size of the last block (the remainder).

Partition

public static Tuple2<java.lang.Long,java.lang.Integer> Partition(long size,
                                                 int partitionSize)

Partitions the range [0, size) into blocks of partitionSize.

Parameters:

size - The specified size.

partitionSize - The specified partition size.

Returns:

A pair that contains the number of blocks in the first element and the size of the last block (the remainder).