IntSignalSourceVector (BandM signal & music)

All Superinterfaces:

Collection<S>, Iterable<S>, List<S>

All Known Subinterfaces:

IntClockedSignalSourceVector, IntSignalSourceVector.Mutable<S>

All Known Implementing Classes:

IntDelayVector
```
public interface IntSignalSourceVector<S extends IntSignalSource>
extends List<S>
```
Interface of aggregates of signal sources of primitive type int.
This interface is intended for grouping signal sources and routing parallel data flow at contruction time of a network. Objects that implement this interface should not themselves contribute to realtime behavior.

See Also:

PrimitiveIntSignalSourceVector, IntSignalSource

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`IntSignalSourceVector.Mutable<S extends IntSignalSource>` Interface of mutable aggregates of signal sources of primitive type `int`.

Method Summary

All Methods Static Methods Instance Methods Default Methods
Modifier and Type	Method and Description
`default IntSignalSourceVector<S>`	`append(IntSignalSourceVector<S> other)` Returns a new aggregate that combines the components of this and the given other aggregate in order.
`static <S extends IntSignalSource> IntSignalSourceVector<S>`	`empty()` Creates a new aggregate with zero components.
`static <S extends IntSignalSource> IntSignalSourceVector<S>`	`iterate(int size, Supplier<? extends S> producer)` Creates a new aggregate with a given number components obtained from a producer.
`default IntSignalSourceVector<IntSignalSource>`	`map(IntUnaryOperator op)` Returns a new aggregate that is obtained by uniformly transforming the values of the corresponding components of this aggregate.
`static <S extends IntSignalSource> IntSignalSourceVector.Mutable<S>`	`of(int size)` Creates a mutable aggregate of the given size.
`static <S extends IntSignalSource> IntSignalSourceVector<S>`	`of(int size, IntFunction<? extends S> components)` Creates a new aggregate from the given component-valued function.
`static <S extends IntSignalSource> IntSignalSourceVector<S>`	`of(List<? extends S> components)` Creates a new aggregate from the given list of components.
`static <S extends IntSignalSource> IntSignalSourceVector<S>`	`of(S... components)` Creates a new aggregate from the given array of components.
`static <S extends IntSignalSource> IntSignalSourceVector<S>`	`repeat(int size, S source)` Creates a new aggregate with a given number of identical references to the same given signal source.
`static <S extends IntSignalSource> IntSignalSourceVector<S>`	`singleton(S source)` Creates a new aggregate with one component.
`default int`	`sizeCompatibleWith(int expected)` Returns the number of components of this aggregate if equal to the expected value.
`default int`	`sizeCompatibleWith(List<?> expected)`
`default int`	`sizeCompatibleWith(Object... expected)`
`default IntClockedSignalSourceVector`	`stored()` Returns a new aggegate whose components take snapshots of the corresponding components of this aggregate.
`default IntSignalSourceVector<IntSignalSource>`	`zipWith(IntBinaryOperator op, IntSignalSourceVector<?> other)` Returns a new aggregate that is obtained by uniformly combining the values of the corresponding components of this and another aggregate.

Methods inherited from interface java.util.List
add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable
forEach

- Method Detail
  - sizeCompatibleWith
```
@Undocumented
default int sizeCompatibleWith(List<?> expected)
```
  - sizeCompatibleWith
```
@Undocumented
default int sizeCompatibleWith(Object... expected)
```
  - sizeCompatibleWith
```
default int sizeCompatibleWith(int expected)
```
    Returns the number of components of this aggregate if equal to the expected value.
    
    Parameters:
    
    expected - the expected number of components
    
    Returns:
    
    the number of elements of this aggregate
    
    Throws:
    
    IllegalArgumentException - if the number of components of this aggregate is not equal to the expected number
  - of
```
@SafeVarargs
static <S extends IntSignalSource> IntSignalSourceVector<S> of(S... components)
```
    Creates a new aggregate from the given array of components.
    The resulting object is a view of the passed array; concurrent mutation of array elements is observed. For immutable aggregates, no reference to the array should be shared.
    
    Parameters:
    
    components - the components
    
    Throws:
    
    NullPointerException - if components == null
  - of
```
static <S extends IntSignalSource> IntSignalSourceVector<S> of(List<? extends S> components)
```
    Creates a new aggregate from the given list of components.
    The specified list is copied internally; later mutations of the original are not reflected.
    
    Parameters:
    
    components - the components
    
    Throws:
    
    NullPointerException - if components == null
  - of
```
static <S extends IntSignalSource> IntSignalSourceVector.Mutable<S> of(int size)
```
    Creates a mutable aggregate of the given size. All components are initialized with null and must be set before use.
    
    Parameters:
    
    size - the number of components of the new aggregate
  - of
```
static <S extends IntSignalSource> IntSignalSourceVector<S> of(int size,
                                                               IntFunction<? extends S> components)
```
    Creates a new aggregate from the given component-valued function.
    The given function is evaluated for all valid indices, from 0 to size-1, in unspecified order.
    
    Parameters:
    
    components - the component function
    
    Throws:
    
    NullPointerException - if components == null
  - repeat
```
static <S extends IntSignalSource> IntSignalSourceVector<S> repeat(int size,
                                                                   S source)
```
    Creates a new aggregate with a given number of identical references to the same given signal source.
    
    Parameters:
    
    size - the number of elements of the new aggregate
    
    source - the signal source to use as component
    
    Throws:
    
    IllegalArgumentException - if size < 0
  - iterate
```
static <S extends IntSignalSource> IntSignalSourceVector<S> iterate(int size,
                                                                    Supplier<? extends S> producer)
```
    Creates a new aggregate with a given number components obtained from a producer.
    
    Parameters:
    
    size - the number of elements of the new aggregate
    
    producer - the producer of signal source components
    
    Throws:
    
    IllegalArgumentException - if size < 0
  - empty
```
static <S extends IntSignalSource> IntSignalSourceVector<S> empty()
```
    Creates a new aggregate with zero components.
  - singleton
```
static <S extends IntSignalSource> IntSignalSourceVector<S> singleton(S source)
```
    Creates a new aggregate with one component.
    
    Parameters:
    
    source - the component of the new aggregate
  - append
```
default IntSignalSourceVector<S> append(IntSignalSourceVector<S> other)
```
    Returns a new aggregate that combines the components of this and the given other aggregate in order.
    For app = this.append(other), it holds that app.size() == this.size() + other.size(); furthermore, for m = this.size(), app.get(i) == this.get(i) holds for i < m, and app.get(i) == other.get(i - m) holds for i >= m.
    
    Parameters:
    
    other - the other aggregate
  - map
```
default IntSignalSourceVector<IntSignalSource> map(IntUnaryOperator op)
```
    Returns a new aggregate that is obtained by uniformly transforming the values of the corresponding components of this aggregate.
    For that = this.map(f), it holds that that.size() == this.size(); furthermore, at any point in time, that.get(i).getAsInt() == op.applyAsInt(this.get(i).getAsInt()) holds.
    
    Parameters:
    
    op - the operator to apply to the values of all components
    
    See Also:
    
    IntSignalSource.map(IntUnaryOperator)
  - zipWith
```
default IntSignalSourceVector<IntSignalSource> zipWith(IntBinaryOperator op,
                                                       IntSignalSourceVector<?> other)
```
    Returns a new aggregate that is obtained by uniformly combining the values of the corresponding components of this and another aggregate.
    For that = this.map(f), it holds that that.size() == this.size() == other.size(); furthermore, at any point in time, that.get(i).getAsInt() == op.applyAsInt(this.get(i).getAsInt(), other.get(i).getAsInt()) holds.
    
    Parameters:
    
    op - the operator to apply to the values of all components
    
    Throws:
    
    IllegalArgumentException - if the two aggregates are of different size
    
    See Also:
    
    IntSignalSource.zipWith(IntBinaryOperator, IntSignalSource)
  - stored
```
default IntClockedSignalSourceVector stored()
```
    Returns a new aggegate whose components take snapshots of the corresponding components of this aggregate.
    
    See Also:
    
    IntSignalSource.stored()

Interface IntSignalSourceVector<S extends IntSignalSource>

Nested Class Summary

Method Summary

Methods inherited from interface java.util.List

Methods inherited from interface java.util.Collection

Methods inherited from interface java.lang.Iterable

Method Detail

sizeCompatibleWith

sizeCompatibleWith

sizeCompatibleWith

of

of

of

of

repeat

iterate

empty

singleton

append

map

zipWith

stored