org.eclipse.collections.api.bimap.ImmutableBiMap Maven / Gradle / Ivy
/*
* Copyright (c) 2018 Goldman Sachs and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* and Eclipse Distribution License v. 1.0 which accompany this distribution.
* The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
* and the Eclipse Distribution License is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*/
package org.eclipse.collections.api.bimap;
import org.eclipse.collections.api.bag.ImmutableBagIterable;
import org.eclipse.collections.api.block.function.Function;
import org.eclipse.collections.api.block.function.Function2;
import org.eclipse.collections.api.block.predicate.Predicate;
import org.eclipse.collections.api.block.predicate.Predicate2;
import org.eclipse.collections.api.block.procedure.Procedure;
import org.eclipse.collections.api.factory.BiMaps;
import org.eclipse.collections.api.map.ImmutableMapIterable;
import org.eclipse.collections.api.multimap.set.ImmutableSetMultimap;
import org.eclipse.collections.api.ordered.OrderedIterable;
import org.eclipse.collections.api.partition.set.PartitionImmutableSet;
import org.eclipse.collections.api.set.ImmutableSet;
import org.eclipse.collections.api.tuple.Pair;
/**
* A {@link BiMap} whose contents cannot be altered after initialization.
*
* @since 4.2
*/
public interface ImmutableBiMap extends BiMap, ImmutableMapIterable
{
@Override
ImmutableBiMap newWithKeyValue(K key, V value);
@Override
ImmutableBiMap newWithAllKeyValues(Iterable extends Pair extends K, ? extends V>> keyValues);
@Override
ImmutableBiMap newWithAllKeyValueArguments(Pair extends K, ? extends V>... keyValuePairs);
@Override
ImmutableBiMap newWithoutKey(K key);
@Override
ImmutableBiMap newWithoutAllKeys(Iterable extends K> keys);
@Override
ImmutableBiMap inverse();
@Override
ImmutableSetMultimap flip();
@Override
ImmutableBiMap flipUniqueValues();
@Override
ImmutableBiMap tap(Procedure super V> procedure);
@Override
ImmutableBiMap select(Predicate2 super K, ? super V> predicate);
@Override
ImmutableBiMap reject(Predicate2 super K, ? super V> predicate);
@Override
ImmutableBiMap collect(Function2 super K, ? super V, Pair> function);
@Override
ImmutableBiMap collectValues(Function2 super K, ? super V, ? extends R> function);
@Override
ImmutableSet select(Predicate super V> predicate);
@Override
ImmutableSet selectWith(Predicate2 super V, ? super P> predicate, P parameter);
@Override
ImmutableSet reject(Predicate super V> predicate);
@Override
ImmutableSet rejectWith(Predicate2 super V, ? super P> predicate, P parameter);
@Override
PartitionImmutableSet partition(Predicate super V> predicate);
@Override
PartitionImmutableSet partitionWith(Predicate2 super V, ? super P> predicate, P parameter);
@Override
ImmutableSet selectInstancesOf(Class clazz);
@Override
ImmutableBagIterable collect(Function super V, ? extends V1> function);
@Override
ImmutableBagIterable collectWith(Function2 super V, ? super P, ? extends V1> function, P parameter);
@Override
ImmutableBagIterable collectIf(Predicate super V> predicate, Function super V, ? extends V1> function);
@Override
ImmutableBagIterable flatCollect(Function super V, ? extends Iterable> function);
/**
* @since 9.2
*/
@Override
default ImmutableBagIterable flatCollectWith(Function2 super V, ? super P, ? extends Iterable> function, P parameter)
{
return this.flatCollect(each -> function.apply(each, parameter));
}
@Override
ImmutableSetMultimap groupBy(Function super V, ? extends V1> function);
@Override
ImmutableSetMultimap groupByEach(Function super V, ? extends Iterable> function);
@Override
default ImmutableBiMap groupByUniqueKey(Function super V, ? extends VV> function)
{
MutableBiMap target = BiMaps.mutable.empty();
return this.groupByUniqueKey(function, target).toImmutable();
}
/**
* @deprecated in 8.0. Use {@link OrderedIterable#zip(Iterable)} instead.
*/
@Override
@Deprecated
ImmutableSet> zip(Iterable that);
/**
* @deprecated in 8.0. Use {@link OrderedIterable#zipWithIndex()} instead.
*/
@Override
@Deprecated
ImmutableSet> zipWithIndex();
}