/*
	* Copyright (C) 2002-2019 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.longs;
import it.unimi.dsi.fastutil.objects.ObjectIterator;
import it.unimi.dsi.fastutil.objects.ObjectIterable;
import it.unimi.dsi.fastutil.objects.ObjectSet;
import it.unimi.dsi.fastutil.objects.ObjectSets;
import it.unimi.dsi.fastutil.chars.CharCollection;
import it.unimi.dsi.fastutil.chars.CharCollections;
import it.unimi.dsi.fastutil.chars.CharSets;
import java.util.Map;
import java.util.function.Consumer;
import it.unimi.dsi.fastutil.longs.Long2CharMap.FastEntrySet;
A class providing static methods and objects that do useful things with
type-specific maps.
See Also:
Collections/**
 * A class providing static methods and objects that do useful things with
 * type-specific maps.
 *
 * @see java.util.Collections
 */
public final class Long2CharMaps {
	private Long2CharMaps() {
	}
	
Returns an iterator that will be fast, if possible, on the entry set of the provided map. 
Params:
map – 
           a map from which we will try to extract a (fast) iterator on the
           entry set.
Returns:
an iterator on the entry set of the given map that will be fast, if
        possible.
Since:
8.0.0/**
	 * 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<Long2CharMap.Entry> fastIterator(Long2CharMap map) {
		final ObjectSet<Long2CharMap.Entry> entries = map.long2CharEntrySet();
		return entries instanceof Long2CharMap.FastEntrySet
				? ((Long2CharMap.FastEntrySet) entries).fastIterator()
				: entries.iterator();
	}
	
Iterates quickly, if possible, on the entry set of the provided map. 
Params:
map –  a map on which we will try to iterate quickly.
consumer –  the consumer that will be passed to FastEntrySet.fastForEach(Consumer<? super Entry>), if possible, or to Iterable.forEach(Consumer).
Since:
8.1.0/**
	 * 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(Long2CharMap map, final Consumer<? super Long2CharMap.Entry> consumer) {
		final ObjectSet<Long2CharMap.Entry> entries = map.long2CharEntrySet();
		if (entries instanceof Long2CharMap.FastEntrySet)
			((Long2CharMap.FastEntrySet) entries).fastForEach(consumer);
		else
			entries.forEach(consumer);
	}
	
Returns an iterable yielding an iterator that will be fast, if possible, on the entry set of the provided map. 
Params:
map – 
           a map from which we will try to extract an iterable yielding a
           (fast) iterator on the entry set.
Returns:
an iterable yielding an iterator on the entry set of the given map
        that will be fast, if possible.
Since:
8.0.0/**
	 * 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<Long2CharMap.Entry> fastIterable(Long2CharMap map) {
		final ObjectSet<Long2CharMap.Entry> entries = map.long2CharEntrySet();
		return entries instanceof Long2CharMap.FastEntrySet ? new ObjectIterable<Long2CharMap.Entry>() {
			public ObjectIterator<Long2CharMap.Entry> iterator() {
				return ((Long2CharMap.FastEntrySet) entries).fastIterator();
			}
			public void forEach(final Consumer<? super Long2CharMap.Entry> consumer) {
				((Long2CharMap.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.
/**
	 * An immutable class representing an empty type-specific map.
	 *
	 * <p>
	 * This class may be useful to implement your own in case you subclass a
	 * type-specific map.
	 */
	public static class EmptyMap extends Long2CharFunctions.EmptyFunction
			implements
				Long2CharMap,
				java.io.Serializable,
				Cloneable {
		private static final long serialVersionUID = -7046029254386353129L;
		protected EmptyMap() {
		}
		@Override
		public boolean containsValue(final char v) {
			return false;
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@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<? extends Long, ? extends Character> m) {
			throw new UnsupportedOperationException();
		}
		@SuppressWarnings("unchecked")
		@Override
		public ObjectSet<Long2CharMap.Entry> long2CharEntrySet() {
			return ObjectSets.EMPTY_SET;
		}

		@Override
		public LongSet keySet() {
			return LongSets.EMPTY_SET;
		}

		@Override
		public CharCollection values() {
			return CharSets.EMPTY_SET;
		}
		@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.
/**
	 * 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.
/**
	 * An immutable class representing a type-specific singleton map.
	 *
	 * <p>
	 * This class may be useful to implement your own in case you subclass a
	 * type-specific map.
	 */
	public static class Singleton extends Long2CharFunctions.Singleton
			implements
				Long2CharMap,
				java.io.Serializable,
				Cloneable {
		private static final long serialVersionUID = -7046029254386353129L;
		protected transient ObjectSet<Long2CharMap.Entry> entries;
		protected transient LongSet keys;
		protected transient CharCollection values;
		protected Singleton(final long key, final char value) {
			super(key, value);
		}
		@Override
		public boolean containsValue(final char v) {
			return ((value) == (v));
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public boolean containsValue(final Object ov) {
			return ((((Character) (ov)).charValue()) == (value));
		}
		@Override
		public void putAll(final Map<? extends Long, ? extends Character> m) {
			throw new UnsupportedOperationException();
		}
		@Override
		public ObjectSet<Long2CharMap.Entry> long2CharEntrySet() {
			if (entries == null)
				entries = ObjectSets.singleton(new AbstractLong2CharMap.BasicEntry(key, value));
			return entries;
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		@SuppressWarnings({"rawtypes", "unchecked"})
		public ObjectSet<Map.Entry<Long, Character>> entrySet() {
			return (ObjectSet) long2CharEntrySet();
		}
		@Override
		public LongSet keySet() {
			if (keys == null)
				keys = LongSets.singleton(key);
			return keys;
		}
		@Override
		public CharCollection values() {
			if (values == null)
				values = CharSets.singleton(value);
			return values;
		}
		@Override
		public boolean isEmpty() {
			return false;
		}
		@Override
		public int hashCode() {
			return it.unimi.dsi.fastutil.HashCommon.long2int(key) ^ (value);
		}
		@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.
Params:
key – 
           the only key of the returned map.
value – 
           the only value of the returned map.
Returns:
a type-specific immutable map containing just the pair &lt;key,value&gt;./**
	 * Returns a type-specific immutable map containing only the specified pair. The
	 * returned map is serializable and cloneable.
	 *
	 * <p>
	 * 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 &lt;key,value&gt;}.
	 */
	public static Long2CharMap singleton(final long key, char 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.
Params:
key – 
           the only key of the returned map.
value – 
           the only value of the returned map.
Returns:
a type-specific immutable map containing just the pair &lt;key,value&gt;./**
	 * Returns a type-specific immutable map containing only the specified pair. The
	 * returned map is serializable and cloneable.
	 *
	 * <p>
	 * 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 &lt;key,value&gt;}.
	 */
	public static Long2CharMap singleton(final Long key, final Character value) {
		return new Singleton((key).longValue(), (value).charValue());
	}
	
A synchronized wrapper class for maps. /** A synchronized wrapper class for maps. */
	public static class SynchronizedMap extends Long2CharFunctions.SynchronizedFunction
			implements
				Long2CharMap,
				java.io.Serializable {
		private static final long serialVersionUID = -7046029254386353129L;
		protected final Long2CharMap map;
		protected transient ObjectSet<Long2CharMap.Entry> entries;
		protected transient LongSet keys;
		protected transient CharCollection values;
		protected SynchronizedMap(final Long2CharMap m, final Object sync) {
			super(m, sync);
			this.map = m;
		}
		protected SynchronizedMap(final Long2CharMap m) {
			super(m);
			this.map = m;
		}
		@Override
		public boolean containsValue(final char v) {
			synchronized (sync) {
				return map.containsValue(v);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@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<? extends Long, ? extends Character> m) {
			synchronized (sync) {
				map.putAll(m);
			}
		}
		@Override
		public ObjectSet<Long2CharMap.Entry> long2CharEntrySet() {
			synchronized (sync) {
				if (entries == null)
					entries = ObjectSets.synchronize(map.long2CharEntrySet(), sync);
				return entries;
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		@SuppressWarnings({"unchecked", "rawtypes"})
		public ObjectSet<Map.Entry<Long, Character>> entrySet() {
			return (ObjectSet) long2CharEntrySet();
		}
		@Override
		public LongSet keySet() {
			synchronized (sync) {
				if (keys == null)
					keys = LongSets.synchronize(map.keySet(), sync);
				return keys;
			}
		}
		@Override
		public CharCollection values() {
			synchronized (sync) {
				if (values == null)
					return CharCollections.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 char getOrDefault(final long key, final char defaultValue) {
			synchronized (sync) {
				return map.getOrDefault(key, defaultValue);
			}
		}
		@Override
		public void forEach(final java.util.function.BiConsumer<? super Long, ? super Character> action) {
			synchronized (sync) {
				map.forEach(action);
			}
		}
		@Override
		public void replaceAll(
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> function) {
			synchronized (sync) {
				map.replaceAll(function);
			}
		}
		@Override
		public char putIfAbsent(final long key, final char value) {
			synchronized (sync) {
				return map.putIfAbsent(key, value);
			}
		}
		@Override
		public boolean remove(final long key, final char value) {
			synchronized (sync) {
				return map.remove(key, value);
			}
		}
		@Override
		public char replace(final long key, final char value) {
			synchronized (sync) {
				return map.replace(key, value);
			}
		}
		@Override
		public boolean replace(final long key, final char oldValue, final char newValue) {
			synchronized (sync) {
				return map.replace(key, oldValue, newValue);
			}
		}
		@Override
		public char computeIfAbsent(final long key, final java.util.function.LongToIntFunction mappingFunction) {
			synchronized (sync) {
				return map.computeIfAbsent(key, mappingFunction);
			}
		}
		@Override
		public char computeIfAbsentNullable(final long key,
				final java.util.function.LongFunction<? extends Character> mappingFunction) {
			synchronized (sync) {
				return map.computeIfAbsentNullable(key, mappingFunction);
			}
		}
		@Override
		public char computeIfAbsentPartial(final long key, final Long2CharFunction mappingFunction) {
			synchronized (sync) {
				return map.computeIfAbsentPartial(key, mappingFunction);
			}
		}
		@Override
		public char computeIfPresent(final long key,
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> remappingFunction) {
			synchronized (sync) {
				return map.computeIfPresent(key, remappingFunction);
			}
		}
		@Override
		public char compute(final long key,
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> remappingFunction) {
			synchronized (sync) {
				return map.compute(key, remappingFunction);
			}
		}
		@Override
		public char merge(final long key, final char value,
				final java.util.function.BiFunction<? super Character, ? super Character, ? extends Character> remappingFunction) {
			synchronized (sync) {
				return map.merge(key, value, remappingFunction);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character getOrDefault(final Object key, final Character defaultValue) {
			synchronized (sync) {
				return map.getOrDefault(key, defaultValue);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@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./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character replace(final Long key, final Character value) {
			synchronized (sync) {
				return map.replace(key, value);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public boolean replace(final Long key, final Character oldValue, final Character newValue) {
			synchronized (sync) {
				return map.replace(key, oldValue, newValue);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character putIfAbsent(final Long key, final Character value) {
			synchronized (sync) {
				return map.putIfAbsent(key, value);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character computeIfAbsent(final Long key,
				final java.util.function.Function<? super Long, ? extends Character> mappingFunction) {
			synchronized (sync) {
				return map.computeIfAbsent(key, mappingFunction);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character computeIfPresent(final Long key,
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> remappingFunction) {
			synchronized (sync) {
				return map.computeIfPresent(key, remappingFunction);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character compute(final Long key,
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> remappingFunction) {
			synchronized (sync) {
				return map.compute(key, remappingFunction);
			}
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character merge(final Long key, final Character value,
				final java.util.function.BiFunction<? super Character, ? super Character, ? extends Character> remappingFunction) {
			synchronized (sync) {
				return map.merge(key, value, remappingFunction);
			}
		}
	}
	
Returns a synchronized type-specific map backed by the given type-specific
map.
Params:
m – 
           the map to be wrapped in a synchronized map.
See Also:
Collections.synchronizedMap(Map<Object,Object>)
Returns:
a synchronized view of the specified map./**
	 * 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 Long2CharMap synchronize(final Long2CharMap m) {
		return new SynchronizedMap(m);
	}
	
Returns a synchronized type-specific map backed by the given type-specific
map, using an assigned object to synchronize.
Params:
m – 
           the map to be wrapped in a synchronized map.
sync – 
           an object that will be used to synchronize the access to the map.
See Also:
Collections.synchronizedMap(Map<Object,Object>)
Returns:
a synchronized view of the specified map./**
	 * 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 Long2CharMap synchronize(final Long2CharMap m, final Object sync) {
		return new SynchronizedMap(m, sync);
	}
	
An unmodifiable wrapper class for maps. /** An unmodifiable wrapper class for maps. */
	public static class UnmodifiableMap extends Long2CharFunctions.UnmodifiableFunction
			implements
				Long2CharMap,
				java.io.Serializable {
		private static final long serialVersionUID = -7046029254386353129L;
		protected final Long2CharMap map;
		protected transient ObjectSet<Long2CharMap.Entry> entries;
		protected transient LongSet keys;
		protected transient CharCollection values;
		protected UnmodifiableMap(final Long2CharMap m) {
			super(m);
			this.map = m;
		}
		@Override
		public boolean containsValue(final char v) {
			return map.containsValue(v);
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@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<? extends Long, ? extends Character> m) {
			throw new UnsupportedOperationException();
		}
		@Override
		public ObjectSet<Long2CharMap.Entry> long2CharEntrySet() {
			if (entries == null)
				entries = ObjectSets.unmodifiable(map.long2CharEntrySet());
			return entries;
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		@SuppressWarnings({"unchecked", "rawtypes"})
		public ObjectSet<Map.Entry<Long, Character>> entrySet() {
			return (ObjectSet) long2CharEntrySet();
		}
		@Override
		public LongSet keySet() {
			if (keys == null)
				keys = LongSets.unmodifiable(map.keySet());
			return keys;
		}
		@Override
		public CharCollection values() {
			if (values == null)
				return CharCollections.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 char getOrDefault(final long key, final char defaultValue) {
			return map.getOrDefault(key, defaultValue);
		}
		@Override
		public void forEach(final java.util.function.BiConsumer<? super Long, ? super Character> action) {
			map.forEach(action);
		}
		@Override
		public void replaceAll(
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> function) {
			throw new UnsupportedOperationException();
		}
		@Override
		public char putIfAbsent(final long key, final char value) {
			throw new UnsupportedOperationException();
		}
		@Override
		public boolean remove(final long key, final char value) {
			throw new UnsupportedOperationException();
		}
		@Override
		public char replace(final long key, final char value) {
			throw new UnsupportedOperationException();
		}
		@Override
		public boolean replace(final long key, final char oldValue, final char newValue) {
			throw new UnsupportedOperationException();
		}
		@Override
		public char computeIfAbsent(final long key, final java.util.function.LongToIntFunction mappingFunction) {
			throw new UnsupportedOperationException();
		}
		@Override
		public char computeIfAbsentNullable(final long key,
				final java.util.function.LongFunction<? extends Character> mappingFunction) {
			throw new UnsupportedOperationException();
		}
		@Override
		public char computeIfAbsentPartial(final long key, final Long2CharFunction mappingFunction) {
			throw new UnsupportedOperationException();
		}
		@Override
		public char computeIfPresent(final long key,
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> remappingFunction) {
			throw new UnsupportedOperationException();
		}
		@Override
		public char compute(final long key,
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> remappingFunction) {
			throw new UnsupportedOperationException();
		}
		@Override
		public char merge(final long key, final char value,
				final java.util.function.BiFunction<? super Character, ? super Character, ? extends Character> remappingFunction) {
			throw new UnsupportedOperationException();
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character getOrDefault(final Object key, final Character defaultValue) {
			return map.getOrDefault(key, defaultValue);
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@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./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character replace(final Long key, final Character value) {
			throw new UnsupportedOperationException();
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public boolean replace(final Long key, final Character oldValue, final Character newValue) {
			throw new UnsupportedOperationException();
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character putIfAbsent(final Long key, final Character value) {
			throw new UnsupportedOperationException();
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character computeIfAbsent(final Long key,
				final java.util.function.Function<? super Long, ? extends Character> mappingFunction) {
			throw new UnsupportedOperationException();
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character computeIfPresent(final Long key,
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> remappingFunction) {
			throw new UnsupportedOperationException();
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character compute(final Long key,
				final java.util.function.BiFunction<? super Long, ? super Character, ? extends Character> remappingFunction) {
			throw new UnsupportedOperationException();
		}
		
{@inheritDoc}
Deprecated:
Please use the corresponding type-specific method instead./**
		 * {@inheritDoc}
		 * 
		 * @deprecated Please use the corresponding type-specific method instead.
		 */
		@Deprecated
		@Override
		public Character merge(final Long key, final Character value,
				final java.util.function.BiFunction<? super Character, ? super Character, ? extends Character> remappingFunction) {
			throw new UnsupportedOperationException();
		}
	}
	
Returns an unmodifiable type-specific map backed by the given type-specific
map.
Params:
m – 
           the map to be wrapped in an unmodifiable map.
See Also:
Collections.unmodifiableMap(Map<? extends Object,? extends Object>)
Returns:
an unmodifiable view of the specified map./**
	 * 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 Long2CharMap unmodifiable(final Long2CharMap m) {
		return new UnmodifiableMap(m);
	}
}