All Downloads are FREE. Search and download functionalities are using the official Maven repository.

it.unimi.dsi.fastutil.doubles.Double2BooleanMaps Maven / Gradle / Ivy

Go to download

fastutil extends the Java Collections Framework by providing type-specific maps, sets, lists, and queues with a small memory footprint and fast access and insertion; it provides also big (64-bit) arrays, sets and lists, sorting algorithms, fast, practical I/O classes for binary and text files, and facilities for memory mapping large files. Note that if you have both this jar and fastutil-core.jar in your dependencies, fastutil-core.jar should be excluded.

There is a newer version: 8.5.15
Show newest version
/*
	* Copyright (C) 2002-2022 Sebastiano Vigna
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	*     http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/
package it.unimi.dsi.fastutil.doubles;

import it.unimi.dsi.fastutil.objects.ObjectIterator;
import it.unimi.dsi.fastutil.objects.ObjectIterable;
import it.unimi.dsi.fastutil.objects.ObjectSpliterator;
import it.unimi.dsi.fastutil.objects.ObjectSet;
import it.unimi.dsi.fastutil.objects.ObjectSets;
import it.unimi.dsi.fastutil.booleans.BooleanCollection;
import it.unimi.dsi.fastutil.booleans.BooleanCollections;
import it.unimi.dsi.fastutil.booleans.BooleanSets;
import java.util.Map;
import java.util.function.Consumer;
import it.unimi.dsi.fastutil.doubles.Double2BooleanMap.FastEntrySet;

/**
 * A class providing static methods and objects that do useful things with type-specific maps.
 *
 * @see java.util.Collections
 */
public final class Double2BooleanMaps {
	private Double2BooleanMaps() {
	}

	/**
	 * Returns an iterator that will be {@linkplain FastEntrySet fast}, if possible, on the
	 * {@linkplain Map#entrySet() entry set} of the provided {@code map}.
	 * 
	 * @param map a map from which we will try to extract a (fast) iterator on the entry set.
	 * @return an iterator on the entry set of the given map that will be fast, if possible.
	 * @since 8.0.0
	 */

	public static ObjectIterator fastIterator(Double2BooleanMap map) {
		final ObjectSet entries = map.double2BooleanEntrySet();
		return entries instanceof Double2BooleanMap.FastEntrySet ? ((Double2BooleanMap.FastEntrySet)entries).fastIterator() : entries.iterator();
	}

	/**
	 * Iterates {@linkplain FastEntrySet#fastForEach(Consumer) quickly}, if possible, on the
	 * {@linkplain Map#entrySet() entry set} of the provided {@code map}.
	 * 
	 * @param map a map on which we will try to iterate {@linkplain FastEntrySet#fastForEach(Consumer)
	 *            quickly}.
	 * @param consumer the consumer that will be passed to {@link FastEntrySet#fastForEach(Consumer)},
	 *            if possible, or to {@link Iterable#forEach(Consumer)}.
	 * @since 8.1.0
	 */

	public static void fastForEach(Double2BooleanMap map, final Consumer consumer) {
		final ObjectSet entries = map.double2BooleanEntrySet();
		if (entries instanceof Double2BooleanMap.FastEntrySet) ((Double2BooleanMap.FastEntrySet)entries).fastForEach(consumer);
		else entries.forEach(consumer);
	}

	/**
	 * Returns an iterable yielding an iterator that will be {@linkplain FastEntrySet fast}, if
	 * possible, on the {@linkplain Map#entrySet() entry set} of the provided {@code map}.
	 * 
	 * @param map a map from which we will try to extract an iterable yielding a (fast) iterator on the
	 *            entry set.
	 * @return an iterable yielding an iterator on the entry set of the given map that will be fast, if
	 *         possible.
	 * @since 8.0.0
	 */

	public static ObjectIterable fastIterable(Double2BooleanMap map) {
		final ObjectSet entries = map.double2BooleanEntrySet();
		return entries instanceof Double2BooleanMap.FastEntrySet ? new ObjectIterable() {
			@Override
			public ObjectIterator iterator() {
				return ((Double2BooleanMap.FastEntrySet)entries).fastIterator();
			}

			@Override
			public ObjectSpliterator spliterator() {
				return entries.spliterator();
			}

			@Override
			public void forEach(final Consumer consumer) {
				((Double2BooleanMap.FastEntrySet)entries).fastForEach(consumer);
			}
		} : entries;
	}

	/**
	 * An immutable class representing an empty type-specific map.
	 *
	 * 

* This class may be useful to implement your own in case you subclass a type-specific map. */ public static class EmptyMap extends Double2BooleanFunctions.EmptyFunction implements Double2BooleanMap, java.io.Serializable, Cloneable { private static final long serialVersionUID = -7046029254386353129L; protected EmptyMap() { } @Override public boolean containsValue(final boolean v) { return false; } @Deprecated @Override public Boolean getOrDefault(final Object key, final Boolean defaultValue) { return defaultValue; } @Override public boolean getOrDefault(final double key, final boolean defaultValue) { return defaultValue; } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public boolean containsValue(final Object ov) { return false; } @Override public void putAll(final Map m) { throw new UnsupportedOperationException(); } @Override public ObjectSet double2BooleanEntrySet() { return ObjectSets.EMPTY_SET; } @Override public DoubleSet keySet() { return DoubleSets.EMPTY_SET; } @Override public BooleanCollection values() { return BooleanSets.EMPTY_SET; } @Override public void forEach(final java.util.function.BiConsumer consumer) { } @Override public Object clone() { return EMPTY_MAP; } @Override public boolean isEmpty() { return true; } @Override public int hashCode() { return 0; } @Override public boolean equals(final Object o) { if (!(o instanceof Map)) return false; return ((Map)o).isEmpty(); } @Override public String toString() { return "{}"; } } /** * An empty type-specific map (immutable). It is serializable and cloneable. */ public static final EmptyMap EMPTY_MAP = new EmptyMap(); /** * An immutable class representing a type-specific singleton map. * *

* This class may be useful to implement your own in case you subclass a type-specific map. */ public static class Singleton extends Double2BooleanFunctions.Singleton implements Double2BooleanMap, java.io.Serializable, Cloneable { private static final long serialVersionUID = -7046029254386353129L; protected transient ObjectSet entries; protected transient DoubleSet keys; protected transient BooleanCollection values; protected Singleton(final double key, final boolean value) { super(key, value); } @Override public boolean containsValue(final boolean v) { return ((value) == (v)); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public boolean containsValue(final Object ov) { return ((((Boolean)(ov)).booleanValue()) == (value)); } @Override public void putAll(final Map m) { throw new UnsupportedOperationException(); } @Override public ObjectSet double2BooleanEntrySet() { if (entries == null) entries = ObjectSets.singleton(new AbstractDouble2BooleanMap.BasicEntry(key, value)); return entries; } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override @SuppressWarnings({ "rawtypes", "unchecked" }) public ObjectSet> entrySet() { return (ObjectSet)double2BooleanEntrySet(); } @Override public DoubleSet keySet() { if (keys == null) keys = DoubleSets.singleton(key); return keys; } @Override public BooleanCollection values() { if (values == null) values = BooleanSets.singleton(value); return values; } @Override public boolean isEmpty() { return false; } @Override public int hashCode() { return it.unimi.dsi.fastutil.HashCommon.double2int(key) ^ (value ? 1231 : 1237); } @Override public boolean equals(final Object o) { if (o == this) return true; if (!(o instanceof Map)) return false; Map m = (Map)o; if (m.size() != 1) return false; return m.entrySet().iterator().next().equals(entrySet().iterator().next()); } @Override public String toString() { return "{" + key + "=>" + value + "}"; } } /** * Returns a type-specific immutable map containing only the specified pair. The returned map is * serializable and cloneable. * *

* Note that albeit the returned map is immutable, its default return value may be changed. * * @param key the only key of the returned map. * @param value the only value of the returned map. * @return a type-specific immutable map containing just the pair {@code <key,value>}. */ public static Double2BooleanMap singleton(final double key, boolean value) { return new Singleton(key, value); } /** * Returns a type-specific immutable map containing only the specified pair. The returned map is * serializable and cloneable. * *

* Note that albeit the returned map is immutable, its default return value may be changed. * * @param key the only key of the returned map. * @param value the only value of the returned map. * @return a type-specific immutable map containing just the pair {@code <key,value>}. */ public static Double2BooleanMap singleton(final Double key, final Boolean value) { return new Singleton((key).doubleValue(), (value).booleanValue()); } /** A synchronized wrapper class for maps. */ public static class SynchronizedMap extends Double2BooleanFunctions.SynchronizedFunction implements Double2BooleanMap, java.io.Serializable { private static final long serialVersionUID = -7046029254386353129L; protected final Double2BooleanMap map; protected transient ObjectSet entries; protected transient DoubleSet keys; protected transient BooleanCollection values; protected SynchronizedMap(final Double2BooleanMap m, final Object sync) { super(m, sync); this.map = m; } protected SynchronizedMap(final Double2BooleanMap m) { super(m); this.map = m; } @Override public boolean containsValue(final boolean v) { synchronized (sync) { return map.containsValue(v); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public boolean containsValue(final Object ov) { synchronized (sync) { return map.containsValue(ov); } } @Override public void putAll(final Map m) { synchronized (sync) { map.putAll(m); } } @Override public ObjectSet double2BooleanEntrySet() { synchronized (sync) { if (entries == null) entries = ObjectSets.synchronize(map.double2BooleanEntrySet(), sync); return entries; } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override @SuppressWarnings({ "unchecked", "rawtypes" }) public ObjectSet> entrySet() { return (ObjectSet)double2BooleanEntrySet(); } @Override public DoubleSet keySet() { synchronized (sync) { if (keys == null) keys = DoubleSets.synchronize(map.keySet(), sync); return keys; } } @Override public BooleanCollection values() { synchronized (sync) { if (values == null) values = BooleanCollections.synchronize(map.values(), sync); return values; } } @Override public boolean isEmpty() { synchronized (sync) { return map.isEmpty(); } } @Override public int hashCode() { synchronized (sync) { return map.hashCode(); } } @Override public boolean equals(final Object o) { if (o == this) return true; synchronized (sync) { return map.equals(o); } } private void writeObject(java.io.ObjectOutputStream s) throws java.io.IOException { synchronized (sync) { s.defaultWriteObject(); } } // Defaultable methods @Override public boolean getOrDefault(final double key, final boolean defaultValue) { synchronized (sync) { return map.getOrDefault(key, defaultValue); } } @Override public void forEach(final java.util.function.BiConsumer action) { synchronized (sync) { map.forEach(action); } } @Override public void replaceAll(final java.util.function.BiFunction function) { synchronized (sync) { map.replaceAll(function); } } @Override public boolean putIfAbsent(final double key, final boolean value) { synchronized (sync) { return map.putIfAbsent(key, value); } } @Override public boolean remove(final double key, final boolean value) { synchronized (sync) { return map.remove(key, value); } } @Override public boolean replace(final double key, final boolean value) { synchronized (sync) { return map.replace(key, value); } } @Override public boolean replace(final double key, final boolean oldValue, final boolean newValue) { synchronized (sync) { return map.replace(key, oldValue, newValue); } } @Override public boolean computeIfAbsent(final double key, final java.util.function.DoublePredicate mappingFunction) { synchronized (sync) { return map.computeIfAbsent(key, mappingFunction); } } @Override public boolean computeIfAbsentNullable(final double key, final java.util.function.DoubleFunction mappingFunction) { synchronized (sync) { return map.computeIfAbsentNullable(key, mappingFunction); } } @Override public boolean computeIfAbsent(final double key, final Double2BooleanFunction mappingFunction) { synchronized (sync) { return map.computeIfAbsent(key, mappingFunction); } } @Override public boolean computeIfPresent(final double key, final java.util.function.BiFunction remappingFunction) { synchronized (sync) { return map.computeIfPresent(key, remappingFunction); } } @Override public boolean compute(final double key, final java.util.function.BiFunction remappingFunction) { synchronized (sync) { return map.compute(key, remappingFunction); } } @Override public boolean merge(final double key, final boolean value, final java.util.function.BiFunction remappingFunction) { synchronized (sync) { return map.merge(key, value, remappingFunction); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean getOrDefault(final Object key, final Boolean defaultValue) { synchronized (sync) { return map.getOrDefault(key, defaultValue); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public boolean remove(final Object key, final Object value) { synchronized (sync) { return map.remove(key, value); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean replace(final Double key, final Boolean value) { synchronized (sync) { return map.replace(key, value); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public boolean replace(final Double key, final Boolean oldValue, final Boolean newValue) { synchronized (sync) { return map.replace(key, oldValue, newValue); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean putIfAbsent(final Double key, final Boolean value) { synchronized (sync) { return map.putIfAbsent(key, value); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean computeIfAbsent(final Double key, final java.util.function.Function mappingFunction) { synchronized (sync) { return map.computeIfAbsent(key, mappingFunction); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean computeIfPresent(final Double key, final java.util.function.BiFunction remappingFunction) { synchronized (sync) { return map.computeIfPresent(key, remappingFunction); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean compute(final Double key, final java.util.function.BiFunction remappingFunction) { synchronized (sync) { return map.compute(key, remappingFunction); } } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean merge(final Double key, final Boolean value, final java.util.function.BiFunction remappingFunction) { synchronized (sync) { return map.merge(key, value, remappingFunction); } } } /** * Returns a synchronized type-specific map backed by the given type-specific map. * * @param m the map to be wrapped in a synchronized map. * @return a synchronized view of the specified map. * @see java.util.Collections#synchronizedMap(Map) */ public static Double2BooleanMap synchronize(final Double2BooleanMap m) { return new SynchronizedMap(m); } /** * Returns a synchronized type-specific map backed by the given type-specific map, using an assigned * object to synchronize. * * @param m the map to be wrapped in a synchronized map. * @param sync an object that will be used to synchronize the access to the map. * @return a synchronized view of the specified map. * @see java.util.Collections#synchronizedMap(Map) */ public static Double2BooleanMap synchronize(final Double2BooleanMap m, final Object sync) { return new SynchronizedMap(m, sync); } /** An unmodifiable wrapper class for maps. */ public static class UnmodifiableMap extends Double2BooleanFunctions.UnmodifiableFunction implements Double2BooleanMap, java.io.Serializable { private static final long serialVersionUID = -7046029254386353129L; protected final Double2BooleanMap map; protected transient ObjectSet entries; protected transient DoubleSet keys; protected transient BooleanCollection values; protected UnmodifiableMap(final Double2BooleanMap m) { super(m); this.map = m; } @Override public boolean containsValue(final boolean v) { return map.containsValue(v); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public boolean containsValue(final Object ov) { return map.containsValue(ov); } @Override public void putAll(final Map m) { throw new UnsupportedOperationException(); } @SuppressWarnings({ "unchecked", "rawtypes" }) @Override public ObjectSet double2BooleanEntrySet() { if (entries == null) entries = ObjectSets.unmodifiable((ObjectSet)map.double2BooleanEntrySet()); return entries; } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @SuppressWarnings({ "unchecked", "rawtypes" }) @Override public ObjectSet> entrySet() { return (ObjectSet)double2BooleanEntrySet(); } @Override public DoubleSet keySet() { if (keys == null) keys = DoubleSets.unmodifiable(map.keySet()); return keys; } @Override public BooleanCollection values() { if (values == null) values = BooleanCollections.unmodifiable(map.values()); return values; } @Override public boolean isEmpty() { return map.isEmpty(); } @Override public int hashCode() { return map.hashCode(); } @Override public boolean equals(final Object o) { if (o == this) return true; return map.equals(o); } // Defaultable methods @Override public boolean getOrDefault(final double key, final boolean defaultValue) { return map.getOrDefault(key, defaultValue); } @Override public void forEach(final java.util.function.BiConsumer action) { map.forEach(action); } @Override public void replaceAll(final java.util.function.BiFunction function) { throw new UnsupportedOperationException(); } @Override public boolean putIfAbsent(final double key, final boolean value) { throw new UnsupportedOperationException(); } @Override public boolean remove(final double key, final boolean value) { throw new UnsupportedOperationException(); } @Override public boolean replace(final double key, final boolean value) { throw new UnsupportedOperationException(); } @Override public boolean replace(final double key, final boolean oldValue, final boolean newValue) { throw new UnsupportedOperationException(); } @Override public boolean computeIfAbsent(final double key, final java.util.function.DoublePredicate mappingFunction) { throw new UnsupportedOperationException(); } @Override public boolean computeIfAbsentNullable(final double key, final java.util.function.DoubleFunction mappingFunction) { throw new UnsupportedOperationException(); } @Override public boolean computeIfAbsent(final double key, final Double2BooleanFunction mappingFunction) { throw new UnsupportedOperationException(); } @Override public boolean computeIfPresent(final double key, final java.util.function.BiFunction remappingFunction) { throw new UnsupportedOperationException(); } @Override public boolean compute(final double key, final java.util.function.BiFunction remappingFunction) { throw new UnsupportedOperationException(); } @Override public boolean merge(final double key, final boolean value, final java.util.function.BiFunction remappingFunction) { throw new UnsupportedOperationException(); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean getOrDefault(final Object key, final Boolean defaultValue) { return map.getOrDefault(key, defaultValue); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public boolean remove(final Object key, final Object value) { throw new UnsupportedOperationException(); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean replace(final Double key, final Boolean value) { throw new UnsupportedOperationException(); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public boolean replace(final Double key, final Boolean oldValue, final Boolean newValue) { throw new UnsupportedOperationException(); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean putIfAbsent(final Double key, final Boolean value) { throw new UnsupportedOperationException(); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean computeIfAbsent(final Double key, final java.util.function.Function mappingFunction) { throw new UnsupportedOperationException(); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean computeIfPresent(final Double key, final java.util.function.BiFunction remappingFunction) { throw new UnsupportedOperationException(); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean compute(final Double key, final java.util.function.BiFunction remappingFunction) { throw new UnsupportedOperationException(); } /** * {@inheritDoc} * * @deprecated Please use the corresponding type-specific method instead. */ @Deprecated @Override public Boolean merge(final Double key, final Boolean value, final java.util.function.BiFunction remappingFunction) { throw new UnsupportedOperationException(); } } /** * Returns an unmodifiable type-specific map backed by the given type-specific map. * * @param m the map to be wrapped in an unmodifiable map. * @return an unmodifiable view of the specified map. * @see java.util.Collections#unmodifiableMap(Map) */ public static Double2BooleanMap unmodifiable(final Double2BooleanMap m) { return new UnmodifiableMap(m); } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy