Класс HashMap<K,V>

public HashMap(int initialCapacity, float loadFactor)

Примечание к API:

Чтобы создать HashMap с начальной емкостью, рассчитанной на ожидаемое количество отображений, используйте newHashMap.

Параметры:

initialCapacity — начальная емкость

loadFactor — коэффициент загрузки

Исключения:

IllegalArgumentException — если начальная емкость отрицательна или коэффициент загрузки неположителен

public HashMap(int initialCapacity)

Примечание к API:

Чтобы создать HashMap с начальной емкостью, рассчитанной на ожидаемое количество отображений, используйте newHashMap.

Параметры:

initialCapacity — начальная емкость.

Исключения:

IllegalArgumentException — если начальная емкость отрицательна.

public HashMap()

public HashMap(Map<? extends K, ? extends V> m)

Параметры:

m — карта, отображения которой следует поместить в эту карту

Исключения:

NullPointerException — если указанная карта равна null

public int size()

Определено в:

size в интерфейсе Map<K,V>

Переопределяет:

size в классе AbstractMap<K,V>

Возвращает:

количество отображений «ключ-значение» в этой карте

public boolean isEmpty()

Определено в:

isEmpty в интерфейсе Map<K,V>

Переопределяет:

isEmpty в классе AbstractMap<K,V>

Возвращает:

true, если эта карта не содержит отображений «ключ-значение»

public V get(Object key)

Определено в:

get в интерфейсе Map<K,V>

Переопределяет:

get в классе AbstractMap<K,V>

Параметры:

key — ключ, значение которого необходимо вернуть

Возвращает:

значение, которому соответствует указанный ключ, или null, если в этой карте нет отображения для данного ключа

См. также:

• put(Object, Object)

public boolean containsKey(Object key)

Определено в:

containsKey в интерфейсе Map<K,V>

Переопределяет:

containsKey в классе AbstractMap<K,V>

Параметры:

key — ключ, наличие которого в этой карте необходимо проверить

Возвращает:

true, если эта карта содержит отображение для указанного ключа.

public V put(K key, V value)

Определено в:

put в интерфейсе Map<K,V>

Переопределяет:

put в классе AbstractMap<K,V>

Параметры:

key — ключ, с которым связывается указанное значение

value — значение, связываемое с указанным ключом

Возвращает:

предыдущее значение, связанное с key, или null, если для key не было отображения. (Возвращаемое значение null также может означать, что ранее карта связывала null с key.)

public void putAll(Map<? extends K, ? extends V> m)

Определено в:

putAll в интерфейсе Map<K,V>

Переопределяет:

putAll в классе AbstractMap<K,V>

Параметры:

m — отображения, которые необходимо сохранить в этой карте

Исключения:

NullPointerException — если указанная карта равна null

public V remove(Object key)

Определено в:

remove в интерфейсе Map<K,V>

Переопределяет:

remove в классе AbstractMap<K,V>

Параметры:

key — ключ, отображение которого следует удалить из карты

Возвращает:

предыдущее значение, связанное с key, или null, если для key не было отображения. (Возвращаемое значение null также может означать, что ранее карта связывала null с key.)

public void clear()

Определено в:

clear в интерфейсе Map<K,V>

Переопределяет:

clear в классе AbstractMap<K,V>

public boolean containsValue(Object value)

Определено в:

containsValue в интерфейсе Map<K,V>

Переопределяет:

containsValue в классе AbstractMap<K,V>

Параметры:

value — значение, наличие которого в этой карте необходимо проверить

Возвращает:

true, если эта карта связывает один или несколько ключей с указанным значением

public Set<K> keySet()

Определено в:

keySet в интерфейсе Map<K,V>

Переопределяет:

keySet в классе AbstractMap<K,V>

Возвращает:

представление ключей, содержащихся в этой карте, в виде множества

public Collection<V> values()

Определено в:

values в интерфейсе Map<K,V>

Переопределяет:

values в классе AbstractMap<K,V>

Возвращает:

представление значений, содержащихся в этой карте

public Set<Map.Entry<K,V>> entrySet()

Определено в:

entrySet в интерфейсе Map<K,V>

Возвращает:

представление отображений, содержащихся в этой карте, в виде множества

public V computeIfAbsent(K key, Function<? super K, ? extends V> mappingFunction)

map.computeIfAbsent(key, k -> new Value(f(k)));

map.computeIfAbsent(key, k -> new HashSet<V>()).add(v);

Определено в:

computeIfAbsent в интерфейсе Map<K,V>

Параметры:

key — ключ, с которым связывается указанное значение

mappingFunction — функция отображения для вычисления значения

Возвращает:

текущее (существующее или вычисленное) значение, связанное с указанным ключом, или null, если вычисленное значение равно null

Исключения:

ConcurrentModificationException — если обнаружено, что функция отображения изменила эту карту

public V computeIfPresent(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

Определено в:

computeIfPresent в интерфейсе Map<K,V>

Параметры:

key — ключ, с которым связывается указанное значение

remappingFunction — функция переотображения для вычисления значения

Возвращает:

новое значение, связанное с указанным ключом, или null, если такого значения нет

Исключения:

ConcurrentModificationException — если обнаружено, что функция переотображения изменила эту карту

public V compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

map.compute(key, (k, v) -> (v == null) ? msg : v.concat(msg))

Определено в:

compute в интерфейсе Map<K,V>

Параметры:

key — ключ, с которым связывается указанное значение

remappingFunction — функция переотображения для вычисления значения

Возвращает:

новое значение, связанное с указанным ключом, или null, если такого значения нет

Исключения:

ConcurrentModificationException — если обнаружено, что функция переотображения изменила эту карту

public V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)

map.merge(key, msg, String::concat)

Определено в:

merge в интерфейсе Map<K,V>

Параметры:

key — ключ, с которым связывается результирующее значение

value — ненулевое значение, объединяемое с существующим значением, связанным с ключом, или связываемое с ключом, если существующего значения нет либо с ключом связано значение null

remappingFunction — функция переотображения для повторного вычисления значения, если оно имеется

Возвращает:

новое значение, связанное с указанным ключом, или null, если с ключом не связано никакое значение

Исключения:

ConcurrentModificationException — если обнаружено, что функция переотображения изменила эту карту

public Object clone()

Переопределяет:

clone в классе AbstractMap<K,V>

Возвращает:

поверхностную копию этой карты

См. также:

• Cloneable

public static <K,V> HashMap<K,V> newHashMap(int numMappings)

Параметры типа:

K — тип ключей, хранящихся в новой карте

V — тип отображаемых значений

Параметры:

numMappings — ожидаемое количество отображений

Возвращает:

созданную карту

Исключения:

IllegalArgumentException — если numMappings отрицательно

Начиная с версии:

19