All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class COM.objectspace.jgl.algorithms.Removing

java.lang.Object
   |
   +----COM.objectspace.jgl.algorithms.Removing

public final class Removing

extends Object

See Also:

RemovingExamples

remove(ForwardIterator, ForwardIterator, Object)

Remove all occurrences of an object from a sequence.

remove(Sequence, Object)

Remove all occurrences of an object from a sequence.

removeCopy(Container, Container, Object)

Copy one container to another container, skipping any occurrences of a particular object.

removeCopy(Container, OutputIterator, Object)

Copy a container to a sequence, skipping any occurrences of a particular object.

removeCopy(InputIterator, InputIterator, OutputIterator, Object)

Copy one sequence to another sequence, skipping any occurrences of a particular object.

removeCopyIf(Container, Container, UnaryPredicate)

Copy one container to another container, skipping all objects that satisfy a predicate.

removeCopyIf(Container, OutputIterator, UnaryPredicate)

Copy a container to a sequence, skipping all objects that satisfy a predicate.

removeCopyIf(InputIterator, InputIterator, OutputIterator, UnaryPredicate)

Copy one sequence to another sequence, skipping all objects that satisfy a predicate.

removeIf(ForwardIterator, ForwardIterator, UnaryPredicate)

Remove all objects in a sequence that satisfy a predicate from a sequence.

removeIf(Sequence, UnaryPredicate)

Remove all objects in a sequence that satisfy a predicate from a container.

 public static ForwardIterator remove(ForwardIterator first,
                                      ForwardIterator last,
                                      Object object)

Remove all occurrences of an object from a sequence. The size of the sequence is not altered; if n elements are removed, the last n elements of the sequence will have undefined values. The time complexity is linear and the space complexity is constant.

Parameters:

first - An iterator positioned at the first element of the sequence.

last - An iterator positioned immediately after the last element of the sequence.

object - The object to remove.

Returns:

An iterator positioned immediately after the last remaining element.

Throws: IllegalArgumentException

If the iterators are incompatible or if the containers upon which the iteratore operate is not a COM.objectspace.jgl.Sequence.

 public static ForwardIterator remove(Sequence container,
                                      Object object)

Remove all occurrences of an object from a sequence. The size of the container is not altered; if n elements are removed, the last n elements of the container will have undefined values. The time complexity is linear and the space complexity is constant.

Parameters:

container - The container.

object - The object to remove.

Returns:

An iterator positioned immediately after the last remaining element.

 public static ForwardIterator removeIf(ForwardIterator first,
                                        ForwardIterator last,
                                        UnaryPredicate predicate)

Remove all objects in a sequence that satisfy a predicate from a sequence. The size of the sequence is not altered; if n elements are removed, the last n elements of the sequence will have undefined values. The time complexity is linear and the space complexity is constant.

Parameters:

first - An iterator positioned at the first element of the sequence.

last - An iterator positioned immediately after the last element of the sequence.

predicate - A unary predicate.

Returns:

An iterator positioned immediately after the last remaining element.

Throws: IllegalArgumentException

If the iterators are incompatible or if the containers upon which the iteratore operate is not a COM.objectspace.jgl.Sequence.

 public static ForwardIterator removeIf(Sequence container,
                                        UnaryPredicate predicate)

Remove all objects in a sequence that satisfy a predicate from a container. The size of the container is not altered; if n elements are removed, the last n elements of the container will have undefined values. The time complexity is linear and the space complexity is constant.

Parameters:

container - The container.

predicate - A unary predicate.

Returns:

An iterator positioned immediately after the last remaining element.

 public static OutputIterator removeCopy(InputIterator first,
                                         InputIterator last,
                                         OutputIterator result,
                                         Object object)

Copy one sequence to another sequence, skipping any occurrences of a particular object. The time complexity is linear and the space complexity is constant.

Parameters:

first - An iterator positioned at the first element of the input sequence.

last - An iterator positioned immediately after the last element of the input sequence.

result - An iterator positioned at the first element of the output sequence.

object - The object to remove.

Returns:

An iterator positioned immediately after the last element of the output sequence.

Throws: IllegalArgumentException

If the iterators are incompatible.

 public static OutputIterator removeCopy(Container container,
                                         OutputIterator result,
                                         Object object)

Copy a container to a sequence, skipping any occurrences of a particular object. The time complexity is linear and the space complexity is constant.

Parameters:

container - The source container.

result - An iterator positioned at the first element of the output sequence.

object - The object to remove.

Returns:

An iterator positioned immediately after the last element of the output sequence.

 public static void removeCopy(Container source,
                               Container destination,
                               Object object)

Copy one container to another container, skipping any occurrences of a particular object. The time complexity is linear and the space complexity is constant.

Parameters:

source - The source container.

destination - The destination container.

object - The object to remove.

 public static OutputIterator removeCopyIf(InputIterator first,
                                           InputIterator last,
                                           OutputIterator result,
                                           UnaryPredicate predicate)

Copy one sequence to another sequence, skipping all objects that satisfy a predicate. The time complexity is linear and the space complexity is constant.

Parameters:

first - An iterator positioned at the first element of the input sequence.

last - An iterator positioned immediately after the last element of the input sequence.

result - An iterator positioned at the first element of the output sequence.

predicate - A UnaryPredicate.

Returns:

An iterator positioned immediately after the last element of the output sequence.

Throws: IllegalArgumentException

If the iterators are incompatible.

 public static OutputIterator removeCopyIf(Container container,
                                           OutputIterator result,
                                           UnaryPredicate predicate)

Copy a container to a sequence, skipping all objects that satisfy a predicate. The time complexity is linear and the space complexity is constant.

Parameters:

container - The source container.

result - An iterator positioned at the first element of the output sequence.

predicate - A UnaryPredicate.

Returns:

An iterator positioned immediately after the last element of the output sequence.

 public static void removeCopyIf(Container source,
                                 Container destination,
                                 UnaryPredicate predicate)

Copy one container to another container, skipping all objects that satisfy a predicate. The time complexity is linear and the space complexity is constant.

Parameters:

source - The source container.

destination - The destination container.

predicate - A unary predicate.

All Packages  Class Hierarchy  This Package  Previous  Next  Index