javolution.util.function

Interface Splittable<T>

All Known Subinterfaces:

BitSetService, CollectionService<E>, MapService<K,V>, SetService<E>, SortedMapService<K,V>, SortedSetService<E>, SortedTableService<E>, TableService<E>

public interface Splittable<T>

An object which can be divided in distinct parts and on which the same action may be performed on the parts rather than the whole.

Version:

6.0, July 21, 2013

Author:

Jean-Marie Dautelle

Method Summary

Methods

Modifier and Type	Method and Description
void	perform(Consumer<T> action, T part) Executes a read-only action on the specified part of this object.
T[]	split(int n, boolean threadsafe) Returns n distinct parts of this object.
void	update(Consumer<T> action, T part) Executes an update action on the specified part of this object.

Method Detail

perform

void perform(Consumer<T> action,
           T part)

Executes a read-only action on the specified part of this object.

Parameters:

action - the read-only action.

part - this object or a part of it.

Throws:

UnsupportedOperationException - if the action tries to update the specified part.

split

T[] split(int n,
        boolean threadsafe)

Returns n distinct parts of this object. This method may return an array of size less than n (e.g. an array of size one if this object cannot split).

Parameters:

n - the number of parts.

threadsafe - true if the returned parts can be updated concurrently; false otherwise.

Returns:

the distinct parts (or views) for this object.

Throws:

IllegalArgumentException - if n < 1

update

void update(Consumer<T> action,
          T part)

Executes an update action on the specified part of this object. Any change to the part is reflected in the whole (this object).

Parameters:

action - the action authorized to update this object part.

part - this object or a part of it.