Интерфейс Map<K,V>

int size()

Возвращает:

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

boolean isEmpty()

Возвращает:

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

boolean containsKey(Object key)

Параметры:

key — ключ, наличие которого в этой карте проверяется

Возвращает:

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

Вызывает:

ClassCastException — если тип ключа недопустим для этой карты (необязательно)

NullPointerException — если указанный ключ равен null, а эта карта не допускает ключи null (необязательно)

boolean containsValue(Object value)

Параметры:

value — значение, наличие которого в этой карте проверяется

Возвращает:

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

Вызывает:

ClassCastException — если тип значения недопустим для этой карты (необязательно)

NullPointerException — если указанное значение равно null, а эта карта не допускает значения null (необязательно)

V get(Object key)

Параметры:

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

Возвращает:

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

Вызывает:

ClassCastException — если тип ключа недопустим для этой карты (необязательно)

NullPointerException — если указанный ключ равен null, а эта карта не допускает ключи null (необязательно)

V put(K key, V value)

Параметры:

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

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

Возвращает:

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

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию put

ClassCastException — если класс указанного ключа или значения не позволяет сохранить его в этой карте

NullPointerException — если указанный ключ или значение равны null, а эта карта не допускает ключи или значения null

IllegalArgumentException — если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте

V remove(Object key)

Параметры:

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

Возвращает:

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

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию remove

ClassCastException — если тип ключа недопустим для этой карты (необязательно)

NullPointerException — если указанный ключ равен null, а эта карта не допускает ключи null (необязательно)

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

Параметры:

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

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию putAll

ClassCastException — если класс ключа или значения в указанной карте не позволяет сохранить его в этой карте

NullPointerException — если указанная карта равна null либо если эта карта не допускает ключи или значения null, а указанная карта содержит ключи или значения null

IllegalArgumentException — если какое-либо свойство ключа или значения в указанной карте не позволяет сохранить его в этой карте

void clear()

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию clear

Set<K> keySet()

Возвращает:

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

Collection<V> values()

Возвращает:

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

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

Возвращает:

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

boolean equals(Object o)

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

equals в классе Object

Параметры:

o — объект, который сравнивается с этой картой на равенство

Возвращает:

true, если указанный объект равен этой карте

См. также:

• Object.hashCode()
• HashMap

int hashCode()

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

hashCode в классе Object

Возвращает:

хеш-код этой карты

См. также:

• Map.Entry.hashCode()
• Object.equals(Object)
• equals(Object)

default V getOrDefault(Object key, V defaultValue)

Требования к реализации:

Реализация по умолчанию не дает гарантий относительно свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свойства его конкурентного выполнения.

Параметры:

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

defaultValue — отображение по умолчанию для ключа

Возвращает:

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

Вызывает:

ClassCastException — если тип ключа недопустим для этой карты (необязательно)

NullPointerException — если указанный ключ равен null, а эта карта не допускает ключи null (необязательно)

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

1.8

default void forEach(BiConsumer<? super K, ? super V> action)

Требования к реализации:

Реализация по умолчанию эквивалентна следующему для этой map:

for (Map.Entry<K, V> entry : map.entrySet())
    action.accept(entry.getKey(), entry.getValue());

Реализация по умолчанию не дает гарантий относительно свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свойства его конкурентного выполнения.

Параметры:

action — действие, выполняемое для каждой записи

Вызывает:

NullPointerException — если указанное действие равно null

ConcurrentModificationException — если обнаружено, что запись удалена во время обхода

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

1.8

default void replaceAll(BiFunction<? super K, ? super V, ? extends V> function)

Требования к реализации:

Реализация по умолчанию эквивалентна следующему для этой map:

for (Map.Entry<K, V> entry : map.entrySet())
    entry.setValue(function.apply(entry.getKey(), entry.getValue()));

Реализация по умолчанию не дает гарантий относительно свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свойства его конкурентного выполнения.

Параметры:

function — функция, применяемая к каждой записи

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию replaceAll (необязательно)

ClassCastException — если класс заменяющего значения не позволяет сохранить его в этой карте (необязательно)

NullPointerException — если указанная функция равна null либо если заменяющее значение равно null, а эта карта не допускает значения null (необязательно)

IllegalArgumentException — если какое-либо свойство заменяющего значения не позволяет сохранить его в этой карте (необязательно)

ConcurrentModificationException — если обнаружено, что запись удалена во время обхода

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

1.8

default V putIfAbsent(K key, V value)

Требования к реализации:

Реализация по умолчанию эквивалентна следующему для этой map:

V v = map.get(key);
if (v == null)
    v = map.put(key, value);

return v;

Реализация по умолчанию не дает гарантий относительно свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свойства его конкурентного выполнения.

Параметры:

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

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

Возвращает:

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

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию putIfAbsent (необязательно)

ClassCastException — если тип ключа или значения недопустим для этой карты (необязательно)

NullPointerException — если указанный ключ или значение равны null, а эта карта не допускает ключи или значения null (необязательно)

IllegalArgumentException — если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

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

1.8

default boolean remove(Object key, Object value)

Требования к реализации:

Реализация по умолчанию эквивалентна следующему для этой map:

if (map.containsKey(key) && Objects.equals(map.get(key), value)) {
    map.remove(key);
    return true;
} else
    return false;

Реализация по умолчанию не дает гарантий относительно свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свойства его конкурентного выполнения.

Параметры:

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

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

Возвращает:

true, если значение было удалено

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию remove (необязательно)

ClassCastException — если тип ключа или значения недопустим для этой карты (необязательно)

NullPointerException — если указанный ключ или значение равны null, а эта карта не допускает ключи или значения null (необязательно)

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

1.8

default boolean replace(K key, V oldValue, V newValue)

Требования к реализации:

Реализация по умолчанию эквивалентна следующему для этой map:

if (map.containsKey(key) && Objects.equals(map.get(key), oldValue)) {
    map.put(key, newValue);
    return true;
} else
    return false;

Реализация по умолчанию не выбрасывает NullPointerException для карт, не поддерживающих значения null, если oldValue равен null, кроме случая, когда newValue также равен null.

Реализация по умолчанию не дает гарантий относительно свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свойства его конкурентного выполнения.

Параметры:

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

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

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

Возвращает:

true, если значение было заменено

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию replace (необязательно)

ClassCastException — если класс указанного ключа или значения не позволяет сохранить его в этой карте

NullPointerException — если указанный ключ или newValue равны null, а эта карта не допускает ключи или значения null

NullPointerException — если oldValue равен null, а эта карта не допускает значения null (необязательно)

IllegalArgumentException — если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте

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

1.8

default V replace(K key, V value)

Требования к реализации:

Реализация по умолчанию эквивалентна следующему для этой map:

if (map.containsKey(key)) {
    return map.put(key, value);
} else
    return null;

Реализация по умолчанию не дает гарантий относительно свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свойства его конкурентного выполнения.

Параметры:

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

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

Возвращает:

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

Вызывает:

UnsupportedOperationException — если эта карта не поддерживает операцию replace (необязательно)

ClassCastException — если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

NullPointerException — если указанный ключ или значение равны null, а эта карта не допускает ключи или значения null

IllegalArgumentException — если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте

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

1.8

default 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);

Требования к реализации:

Реализация по умолчанию эквивалентна следующим шагам для этой map с последующим возвратом текущего значения или null, если теперь значение отсутствует:

if (map.get(key) == null) {
    V newValue = mappingFunction.apply(key);
    if (newValue != null)
        map.put(key, newValue);
}

Реализация по умолчанию не дает гарантий обнаружения изменений этой карты функцией сопоставления во время вычисления и, если уместно, сообщения об ошибке. Непараллельные реализации должны переопределить этот метод и по возможности выбрасывать ConcurrentModificationException, если обнаружено, что функция сопоставления изменяет эту карту во время вычисления. Параллельные реализации должны переопределить этот метод и по возможности выбрасывать IllegalStateException, если обнаружено, что функция сопоставления изменяет эту карту во время вычисления и в результате вычисление никогда не завершится.

Реализация по умолчанию не дает гарантий относительно свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свойства его конкурентного выполнения. В частности, все реализации подинтерфейса ConcurrentMap должны указать в документации, применяется ли функция сопоставления атомарно ровно один раз только в том случае, если значение отсутствует.

Параметры:

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

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

Возвращает:

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

Вызывает:

NullPointerException — если указанный ключ равен null, а эта карта не поддерживает ключи null, либо если mappingFunction равен null

UnsupportedOperationException — если эта карта не поддерживает операцию computeIfAbsent (необязательно)

ClassCastException — если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

IllegalArgumentException — если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

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

1.8

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

Требования к реализации:

Реализация по умолчанию эквивалентна выполнению следующих шагов для этого map с последующим возвратом текущего значения или null, если оно отсутствует:

if (map.get(key) != null) {
    V oldValue = map.get(key);
    V newValue = remappingFunction.apply(key, oldValue);
    if (newValue != null)
        map.put(key, newValue);
    else
        map.remove(key);
}

Реализация по умолчанию не гарантирует обнаружение изменения этой карты функцией пересопоставления во время вычисления и, при необходимости, сообщение об ошибке. Реализации без поддержки параллелизма должны переопределять этот метод и, по возможности, выбрасывать ConcurrentModificationException, если обнаружено, что функция пересопоставления изменяет эту карту во время вычисления. Реализации с поддержкой параллелизма должны переопределять этот метод и, по возможности, выбрасывать IllegalStateException, если обнаружено, что функция пересопоставления изменяет эту карту во время вычисления и в результате вычисление никогда не завершится.

Реализация по умолчанию не гарантирует свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределять этот метод и документировать свойства параллелизма. В частности, все реализации подинтерфейса ConcurrentMap должны документировать, применяется ли функция пересопоставления атомарно один раз только в том случае, если значение отсутствует.

Параметры:

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

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

Возвращает:

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

Исключения:

NullPointerException — если указанный ключ равен null, а эта карта не поддерживает ключи null, или если remappingFunction равна null

UnsupportedOperationException — если эта карта не поддерживает операцию computeIfPresent (необязательно)

ClassCastException — если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

IllegalArgumentException — если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

Начиная с:

1.8

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

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

Требования к реализации:

Реализация по умолчанию эквивалентна выполнению следующих шагов для этого map:

V oldValue = map.get(key);
V newValue = remappingFunction.apply(key, oldValue);
if (newValue != null) {
    map.put(key, newValue);
} else if (oldValue != null || map.containsKey(key)) {
    map.remove(key);
}
return newValue;

Реализация по умолчанию не гарантирует обнаружение изменения этой карты функцией пересопоставления во время вычисления и, при необходимости, сообщение об ошибке. Реализации без поддержки параллелизма должны переопределять этот метод и, по возможности, выбрасывать ConcurrentModificationException, если обнаружено, что функция пересопоставления изменяет эту карту во время вычисления. Реализации с поддержкой параллелизма должны переопределять этот метод и, по возможности, выбрасывать IllegalStateException, если обнаружено, что функция пересопоставления изменяет эту карту во время вычисления и в результате вычисление никогда не завершится.

Реализация по умолчанию не гарантирует свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределять этот метод и документировать свойства параллелизма. В частности, все реализации подинтерфейса ConcurrentMap должны документировать, применяется ли функция пересопоставления атомарно один раз только в том случае, если значение отсутствует.

Параметры:

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

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

Возвращает:

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

Исключения:

NullPointerException — если указанный ключ равен null, а эта карта не поддерживает ключи null, или если remappingFunction равна null

UnsupportedOperationException — если эта карта не поддерживает операцию compute (необязательно)

ClassCastException — если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

IllegalArgumentException — если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

Начиная с:

1.8

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

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

Требования к реализации:

Реализация по умолчанию эквивалентна выполнению следующих шагов для этого map с последующим возвратом текущего значения или null, если значение отсутствует:

V oldValue = map.get(key);
V newValue = (oldValue == null) ? value :
             remappingFunction.apply(oldValue, value);
if (newValue == null)
    map.remove(key);
else
    map.put(key, newValue);

Реализация по умолчанию не гарантирует обнаружение изменения этой карты функцией пересопоставления во время вычисления и, при необходимости, сообщение об ошибке. Реализации без поддержки параллелизма должны переопределять этот метод и, по возможности, выбрасывать ConcurrentModificationException, если обнаружено, что функция пересопоставления изменяет эту карту во время вычисления. Реализации с поддержкой параллелизма должны переопределять этот метод и, по возможности, выбрасывать IllegalStateException, если обнаружено, что функция пересопоставления изменяет эту карту во время вычисления и в результате вычисление никогда не завершится.

Реализация по умолчанию не гарантирует свойств синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределять этот метод и документировать свойства параллелизма. В частности, все реализации подинтерфейса ConcurrentMap должны документировать, применяется ли функция пересопоставления атомарно один раз только в том случае, если значение отсутствует.

Параметры:

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

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

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

Возвращает:

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

Исключения:

UnsupportedOperationException — если эта карта не поддерживает операцию merge (необязательно)

ClassCastException — если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

IllegalArgumentException — если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

NullPointerException — если указанный ключ равен null, а эта карта не поддерживает ключи null, или если значение либо remappingFunction равны null

Начиная с:

1.8

static <K,V> Map<K,V> of()

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

K — тип ключа Map

V — тип значения Map

Возвращает:

пустую Map

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ соответствия

v1 — значение соответствия

Возвращает:

Map, содержащее указанное соответствие

Исключения:

NullPointerException — если ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

k3 — ключ третьего соответствия

v3 — значение третьего соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

k3 — ключ третьего соответствия

v3 — значение третьего соответствия

k4 — ключ четвертого соответствия

v4 — значение четвертого соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

k3 — ключ третьего соответствия

v3 — значение третьего соответствия

k4 — ключ четвертого соответствия

v4 — значение четвертого соответствия

k5 — ключ пятого соответствия

v5 — значение пятого соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

k3 — ключ третьего соответствия

v3 — значение третьего соответствия

k4 — ключ четвертого соответствия

v4 — значение четвертого соответствия

k5 — ключ пятого соответствия

v5 — значение пятого соответствия

k6 — ключ шестого соответствия

v6 — значение шестого соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

k3 — ключ третьего соответствия

v3 — значение третьего соответствия

k4 — ключ четвертого соответствия

v4 — значение четвертого соответствия

k5 — ключ пятого соответствия

v5 — значение пятого соответствия

k6 — ключ шестого соответствия

v6 — значение шестого соответствия

k7 — ключ седьмого соответствия

v7 — значение седьмого соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

k3 — ключ третьего соответствия

v3 — значение третьего соответствия

k4 — ключ четвертого соответствия

v4 — значение четвертого соответствия

k5 — ключ пятого соответствия

v5 — значение пятого соответствия

k6 — ключ шестого соответствия

v6 — значение шестого соответствия

k7 — ключ седьмого соответствия

v7 — значение седьмого соответствия

k8 — ключ восьмого соответствия

v8 — значение восьмого соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, K k9, V v9)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

k3 — ключ третьего соответствия

v3 — значение третьего соответствия

k4 — ключ четвертого соответствия

v4 — значение четвертого соответствия

k5 — ключ пятого соответствия

v5 — значение пятого соответствия

k6 — ключ шестого соответствия

v6 — значение шестого соответствия

k7 — ключ седьмого соответствия

v7 — значение седьмого соответствия

k8 — ключ восьмого соответствия

v8 — значение восьмого соответствия

k9 — ключ девятого соответствия

v9 — значение девятого соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, K k9, V v9, K k10, V v10)

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

K — тип ключа Map

V — тип значения Map

Параметры:

k1 — ключ первого соответствия

v1 — значение первого соответствия

k2 — ключ второго соответствия

v2 — значение второго соответствия

k3 — ключ третьего соответствия

v3 — значение третьего соответствия

k4 — ключ четвертого соответствия

v4 — значение четвертого соответствия

k5 — ключ пятого соответствия

v5 — значение пятого соответствия

k6 — ключ шестого соответствия

v6 — значение шестого соответствия

k7 — ключ седьмого соответствия

v7 — значение седьмого соответствия

k8 — ключ восьмого соответствия

v8 — значение восьмого соответствия

k9 — ключ девятого соответствия

v9 — значение девятого соответствия

k10 — ключ десятого соответствия

v10 — значение десятого соответствия

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какой-либо ключ или значение равны null

Начиная с:

9

@SafeVarargs static <K,V> Map<K,V> ofEntries(Map.Entry<? extends K, ? extends V>... entries)

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

Удобно создавать записи карты с помощью метода Map.entry(). Например,

    import static java.util.Map.entry;

    Map<Integer,String> map = Map.ofEntries(
        entry(1, "a"),
        entry(2, "b"),
        entry(3, "c"),
        ...
        entry(26, "z"));

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

K — тип ключа Map

V — тип значения Map

Параметры:

entries — массив Map.Entrys, содержащих ключи и значения, из которых формируется карта

Возвращает:

Map, содержащее указанные соответствия

Исключения:

IllegalArgumentException — если ключи дублируются

NullPointerException — если какая-либо запись, ключ или значение равны null либо массив entries равен null

Начиная с:

9

См. также:

• Map.entry()

static <K,V> Map.Entry<K,V> entry(K k, V v)

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

Для сериализуемого Entry см. AbstractMap.SimpleEntry или AbstractMap.SimpleImmutableEntry.

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

K — тип ключа

V — тип значения

Параметры:

k — ключ

v — значение

Возвращает:

Entry, содержащий указанные ключ и значение

Исключения:

NullPointerException — если ключ или значение равны null

Начиная с:

9

См. также:

• Map.ofEntries()

static <K,V> Map<K,V> copyOf(Map<? extends K, ? extends V> map)

Примечание по реализации:

Если заданная Map является неизменяемой Map, вызов copyOf обычно не создаёт копию.

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

K — тип ключа Map

V — тип значения Map

Параметры:

map — Map, из которой берутся записи; не должна быть null

Возвращает:

Map, содержащую записи из заданной Map

Исключения:

NullPointerException — если map равна null или содержит ключи либо значения null

Начиная с:

10