Skip to main content

interface HashMultiSetCreators

undocumented

Extends: MultiSetBase.Factory<Tp,UT>

Methods​

builder​

Returns an empty builder instance for this type of collection and context.

Definition​

builder<T extends UT>(): WithElem<Tp, T>['builder'];

Type parameters​

NameConstraintsDescription
TUT
example
HashMultiSet.builder<number>()    // => HashMultiSet.Builder<number>

Overrides​

Factory.builder

createContext​

Returns a new HashMultiSet context instance based on the given options.

Definition​

createContext<UT>(options?: {
    countMapContext?: HashMap.Context<UT>;
  }): HashMultiSet.Context<UT>;

Type parameters​

NameDescription
UTthe upper element type for which the context can create instances

Parameters​

NameTypeDescription
options{
    countMapContext?: HashMap.Context<UT>;
  }
(optional) an object containing the following properties:
- countMapContext: (optional) the map context to use for key to count mapping

defaultContext​

Returns the default context for HashMultiSet.

Definition​

defaultContext<UT>(): HashMultiSet.Context<UT>;

Type parameters​

NameDescription
UTthe upper element type for which the context can create instances

empty​

Returns the (singleton) empty instance of this type and context with given key and value types.

Definition​

empty<T extends UT>(): WithElem<Tp, T>['normal'];

Type parameters​

NameConstraintsDescription
TUT
example
HashMultiSet.empty<number>()  // => HashMultiSet<number>
HashMultiSet.empty<string>() // => HashMultiSet<string>

Overrides​

Factory.empty

from​

Returns an immutable multiset of this type and context, containing the values in the given sources StreamSource.

Definitions​

from<T extends UT>(...sources: ArrayNonEmpty<StreamSource.NonEmpty<T>>): WithElem<Tp, T>['nonEmpty'];

from<T extends UT>(...sources: ArrayNonEmpty<StreamSource<T>>): WithElem<Tp, T>['normal'];

Type parameters​

NameConstraintsDescription
TUT

Parameters​

NameTypeDescription
sourcesArrayNonEmpty<StreamSource.NonEmpty<T>>a non-empty array of StreamSource instances containing values to add
example
HashMultiSet.from([1, 2], [2, 3, 4]).toArray()    // => [1, 2, 2, 3, 4]

Overrides​

Factory.from

of​

Returns an immutable multiset of this collection type and context, containing the given values.

Definition​

of<T extends UT>(...values: ArrayNonEmpty<T>): WithElem<Tp, T>['nonEmpty'];

Type parameters​

NameConstraintsDescription
TUT

Parameters​

NameTypeDescription
valuesArrayNonEmpty<T>a non-empty array of values
example
HashMultiSet.of(1, 2, 2)    // => HashMultiSet.NonEmpty<number>

Overrides​

Factory.of

reducer​

Returns a Reducer that appends received items to a MultiSet and returns the MultiSet as a result. When a source is given, the reducer will first create a MultiSet from the source, and then add elements to it.

Definition​

reducer<T extends UT>(source?: StreamSource<T>): Reducer<T, WithElem<Tp, T>['normal']>;

Type parameters​

NameConstraintsDescription
TUT

Parameters​

NameTypeDescription
sourceStreamSource<T>(optional) an initial source of elements to add to
example
const someList = [1, 2, 3];
const result = Stream.range({ start: 20, amount: 5 }).reduce(SortedMultiSet.reducer(someList))
result.toArray() // => [1, 2, 3, 20, 21, 22, 23, 24]
note

uses a MultiSet builder under the hood. If the given source is a MultiSet in the same context, it will directly call .toBuilder().

Overrides​

Factory.reducer