Хеш-таблица (Платформа Java SE 8 b92)

java.lang. Объект
- java.util. Словарь<K, V>
- - java.util. Хеш-таблица <K, V>

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Карта <K, V>

Прямые Известные Подклассы:

Свойства, UIDefaults
```
public class Hashtable<K,V>
extends Dictionary<K,V>
implements Map<K,V>, Cloneable, Serializable
```
Этот class реализует хэш-таблицу, которая отображает ключи на значения. Любой не -null объект может использоваться в качестве ключа или в качестве значения.
Чтобы успешно сохранить и получить объекты от хеш-таблицы, объекты, используемые в качестве, ключи должны реализовать hashCode метод и equals метод.
Экземпляр Hashtable имеет два параметра, которые влияют на его производительность: начальная емкость и коэффициент загрузки. Емкость является числом блоков в хэш-таблице, и начальная емкость является просто емкостью в то время, когда хэш-таблица создается. Отметьте, что хэш-таблица открыта: в случае "хэш-коллизии" единственный блок хранит многократные записи, которые должны искаться последовательно. Коэффициент загрузки является мерой того, как полный хэш-таблице позволяют добраться прежде, чем ее емкость будет автоматически увеличена. Начальная емкость и параметры коэффициента загрузки являются просто подсказками к реализации. Точные детали относительно того, когда и вызывается ли метод перефразировки, являются зависящими от реализации.
Обычно, коэффициент загрузки значения по умолчанию (.75) предложения хороший компромисс между затратами времени и пространства. Более высокие значения уменьшают издержки пространства, но увеличивают стоимость времени, чтобы искать запись (который отражается в большинстве операций Hashtable, включая get и put).
Начальная емкость управляет компромиссом между потраченным впустую пространством и потребностью в rehash операции, которые являются отнимающими много времени. Нет rehash операции будут когда-либо происходить, если начальная емкость будет больше чем максимальное количество записей, то Hashtable будет содержать разделенный на его коэффициент загрузки. Однако, установка начальной емкости слишком высоко может потратить впустую пространство.
Если много записей должны быть превращены в a Hashtable, создание этого с достаточно большой емкостью может позволить записям быть вставленными более эффективно чем разрешение этому выполнить автоматическое перефразирование как необходимый вырастить таблицу.
Этот пример создает хеш-таблицу чисел. Это использует имена чисел как ключи:
```
   
   Hashtable<String, Integer> numbers
     = new Hashtable<String, Integer>();
   numbers.put("one", 1);
   numbers.put("two", 2);
   numbers.put("three", 3);
```
Чтобы получить число, используйте следующий код:
```
   
   Integer n = numbers.get("two");
   if (n != null) {
     System.out.println("two = " + n);
   }
```
iterators, возвращенные методом iterator наборов, возвращенных всеми "методами представления набора этого class", являются сбоем быстро: если Хеш-таблица структурно изменяется когда-либо после того, как iterator создается, всегда кроме через собственный метод remove iterator, iterator бросит a ConcurrentModificationException. Таким образом, перед лицом параллельной модификации, iterator перестал работать быстро и чисто, вместо того, чтобы рискнуть произвольным, недетерминированным поведением в неопределенное время в будущем. Перечисления, возвращенные ключами Хеш-таблицы и методами элементов, не являются сбоем быстро.
Отметьте, что поведение сбоя быстро iterator не может быть гарантировано, как, вообще говоря, невозможно сделать любые трудные гарантии в присутствии несинхронизируемой параллельной модификации. Перестаньте работать быстро iterators бросают ConcurrentModificationException на основе максимальных усилий. Поэтому, было бы неправильно записать программу, которая зависела от этого исключения для его правильности: поведение сбоя быстро iterators должно использоваться только, чтобы обнаружить ошибки.
С Java 2 платформы v1.2, этот class был retrofitted, чтобы реализовать Map интерфейс, делая это элемент Платформы Наборов Java. В отличие от новых реализаций набора, Hashtable синхронизируется. Если ориентированная на многопотоковое исполнение реализация не необходима, рекомендуется использовать HashMap вместо Hashtable. Если ориентированная на многопотоковое исполнение чрезвычайно параллельная реализация требуется, то рекомендуется использовать ConcurrentHashMap вместо Hashtable.
С тех пор:

JDK1.0

См. Также:

Object.equals(java.lang.Object), Object.hashCode(), rehash(), Collection, Map, HashMap, TreeMap, Сериализированная Форма

Сводка конструктора

Конструкторы
Конструктор и Описание
`Hashtable()` Создает новую, пустую хеш-таблицу с емкостью начальной буквы значения по умолчанию (11) и коэффициент загрузки (0.75).
`Hashtable(int initialCapacity)` Создает новую, пустую хеш-таблицу с указанной начальной емкостью и коэффициентом загрузки значения по умолчанию (0.75).
`Hashtable(int initialCapacity, float loadFactor)` Создает новую, пустую хеш-таблицу с указанной начальной емкостью и указанным коэффициентом загрузки.
`Hashtable(Map<? extends K,? extends V> t)` Создает новую хеш-таблицу с теми же самыми отображениями как данная Карта.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`void`	`clear()` Очищает эту хеш-таблицу так, чтобы она не содержала ключей.
`Объект`	`clone()` Создает мелкую копию этой хеш-таблицы.
`V`	`compute(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)` Попытки вычислить отображение для указанного ключа и его тока отображенное значение (или `null` если нет никакого текущего отображения).
`V`	`computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)` Если указанный ключ уже не связывается со значением (или отображается на `null`), пытается вычислить его значение, используя данную отображающуюся функцию и не вводит это в эту карту если `null`.
`V`	`computeIfPresent(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)` Если значение для указанного ключа присутствует и является ненулем, попытки вычислить новое отображение, данное ключ и его ток отображенное значение.
`boolean`	`contains(Object value)` Тесты, если некоторые контурные карты в указанное значение в этой хеш-таблице.
`boolean`	`containsKey(Object key)` Тесты, если указанный объект является ключом в этой хеш-таблице.
`boolean`	`containsValue(Object value)` Возвращает true, если эта хеш-таблица отображает один или более ключей на это значение.
`Enumeration<V>`	`elements()` Возвращает перечисление значений в этой хеш-таблице.
`Set<Map.Entry<K,V>>`	`entrySet()` Возвраты a `Set` представление отображений содержится в этой карте.
`boolean`	`equals(Object o)` Сравнивает указанный Объект с этой Картой для равенства, согласно определению в интерфейсе Карты.
`void`	`forEach(BiConsumer<? super K,? super V> action)` Выполняет данное действие на каждой записи в этой карте, в порядке, записи возвращаются набором записи iterator (который может быть неуказанным), пока все записи не были обработаны, или действие бросает `Exception`.
`V`	`get(Object key)` Возвращает значение, на которое указанный ключ отображается, или `null` если эта карта не содержит отображения для ключа.
`V`	`getOrDefault(Object key, V defaultValue)` Возвращает значение, на которое указанный ключ отображается, или `defaultValue` если эта карта не содержит отображения для ключа.
`int`	`hashCode()` Возвращает значение хэш-кода для этой Карты согласно определению в интерфейсе Карты.
`boolean`	`isEmpty()` Тесты, если эта хеш-таблица не отображает ключей на значения.
`Enumeration<K>`	`keys()` Возвращает перечисление ключей в этой хеш-таблице.
`Set<K>`	`keySet()` Возвраты a `Set` представление ключей содержится в этой карте.
`V`	`merge(K key, V value, BiFunction<? super V,? super V,? extends V> remappingFunction)` Если указанный ключ уже не связывается со значением или связывается с нулем, партнеры он с данным значением.
`V`	`put(K key, V value)` Отображает указанное `key` к указанному `value` в этой хеш-таблице.
`void`	`putAll(Map<? extends K,? extends V> t)` Копии все отображения от указанной карты до этой хеш-таблицы.
`V`	`putIfAbsent(K key, V value)` Если указанный ключ уже не связывается со значением (или отображается на `null`) партнеры это с данным значением и возвратами `null`, еще возвращает текущую стоимость.
`protected void`	`rehash()` Увеличивает емкость и внутренне реорганизовывает эту хеш-таблицу, чтобы разместить и получить доступ к ее записям более эффективно.
`V`	`remove(Object key)` Удаляет ключ (и его соответствующее значение) от этой хеш-таблицы.
`boolean`	`remove(Object key, Object value)` Удаляет запись для указанного ключа, только если это в настоящий момент отображается на указанное значение.
`V`	`replace(K key, V value)` Заменяет запись для указанного ключа, только если это в настоящий момент отображается на некоторое значение.
`boolean`	`replace(K key, V oldValue, V newValue)` Заменяет запись для указанного ключа только если в настоящий момент отображенный на указанное значение.
`void`	`replaceAll(BiFunction<? super K,? super V,? extends V> function)` Замены значение каждой записи с результатом вызова заданной функции на той записи, в записях порядка возвращаются набором записи iterator, до всех записей, были обработаны, или функция выдает исключение.
`int`	`size()` Возвращает число ключей в этой хеш-таблице.
`Строка`	`toString()` Возвращает строковое представление этого объекта `Hashtable` в форме ряда записей, включенных в фигурные скобки и разделенный символами ASCII " `,` " (запятая и пространство).
`Collection<V>`	`values()` Возвраты a `Collection` представление значений содержится в этой карте.

Методы, наследованные от class java.lang. Объект
finalize, getClass, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - Хеш-таблица
```
public Hashtable(int initialCapacity,
                 float loadFactor)
```
    Создает новую, пустую хеш-таблицу с указанной начальной емкостью и указанным коэффициентом загрузки.
    
    Параметры:
    
    initialCapacity - начальная емкость хеш-таблицы.
    
    loadFactor - коэффициент загрузки хеш-таблицы.
    
    Броски:
    
    IllegalArgumentException - если начальная емкость является меньше чем нуль, или если коэффициент загрузки неположителен.
  - Хеш-таблица
```
public Hashtable(int initialCapacity)
```
    Создает новую, пустую хеш-таблицу с указанной начальной емкостью и коэффициентом загрузки значения по умолчанию (0.75).
    
    Параметры:
    
    initialCapacity - начальная емкость хеш-таблицы.
    
    Броски:
    
    IllegalArgumentException - если начальная емкость является меньше чем нуль.
  - Хеш-таблица
```
public Hashtable()
```
    Создает новую, пустую хеш-таблицу с емкостью начальной буквы значения по умолчанию (11) и коэффициент загрузки (0.75).
  - Хеш-таблица
```
public Hashtable(Map<? extends K,? extends V> t)
```
    Создает новую хеш-таблицу с теми же самыми отображениями как данная Карта. Хеш-таблица создается с начальной емкостью, достаточной, чтобы содержать отображения в данной Карте и коэффициенте загрузки значения по умолчанию (0.75).
    
    Параметры:
    
    t - карта, отображения которой должны быть помещены в эту карту.
    
    Броски:
    
    NullPointerException - если указанная карта является нулем.
    
    С тех пор:
    
    1.2
- Деталь метода
  - размер
```
public int size()
```
    Возвращает число ключей в этой хеш-таблице.
    
    Определенный:
    
    size в интерфейсе Map<K,V>
    
    Определенный:
    
    size в class Dictionary<K,V>
    
    Возвраты:
    
    число ключей в этой хеш-таблице.
  - isEmpty
```
public boolean isEmpty()
```
    Тесты, если эта хеш-таблица не отображает ключей на значения.
    
    Определенный:
    
    isEmpty в интерфейсе Map<K,V>
    
    Определенный:
    
    isEmpty в class Dictionary<K,V>
    
    Возвраты:
    
    true если эта хеш-таблица не отображает ключей на значения; false иначе.
  - ключи
```
public Enumeration<K> keys()
```
    Возвращает перечисление ключей в этой хеш-таблице.
    
    Определенный:
    
    keys в class Dictionary<K,V>
    
    Возвраты:
    
    перечисление ключей в этой хеш-таблице.
    
    См. Также:
    
    Enumeration, elements(), keySet(), Map
  - элементы
```
public Enumeration<V> elements()
```
    Возвращает перечисление значений в этой хеш-таблице. Используйте методы Enumeration на возвращенном объекте выбрать элементы последовательно.
    
    Определенный:
    
    elements в class Dictionary<K,V>
    
    Возвраты:
    
    перечисление значений в этой хеш-таблице.
    
    См. Также:
    
    Enumeration, keys(), values(), Map
  - содержит
```
public boolean contains(Object value)
```
    Тесты, если некоторые контурные карты в указанное значение в этой хеш-таблице. Эта работа более дорога чем containsKey метод.
    Отметьте, что этот метод идентичен в функциональности containsValue, (который является частью Map интерфейс в платформе наборов).
    
    Параметры:
    
    value - значение, чтобы искать
    
    Возвраты:
    
    true если и только если некоторые контурные карты к value параметр в этой хеш-таблице как определено методом equals; false иначе.
    
    Броски:
    
    NullPointerException - если значение null
  - containsValue
```
public boolean containsValue(Object value)
```
    Возвращает true, если эта хеш-таблица отображает один или более ключей на это значение.
    Отметьте, что этот метод идентичен в функциональности contains (который предшествует Map интерфейс).
    
    Определенный:
    
    containsValue в интерфейсе Map<K,V>
    
    Параметры:
    
    value - оцените, чье присутствие в этой хеш-таблице должно быть протестировано
    
    Возвраты:
    
    true, если эта карта отображает один или более ключей на указанное значение
    
    Броски:
    
    NullPointerException - если значение null
    
    С тех пор:
    
    1.2
  - containsKey
```
public boolean containsKey(Object key)
```
    Тесты, если указанный объект является ключом в этой хеш-таблице.
    
    Определенный:
    
    containsKey в интерфейсе Map<K,V>
    
    Параметры:
    
    key - возможный ключ
    
    Возвраты:
    
    true если и только если указанный объект является ключом в этой хеш-таблице, как определено методом equals; false иначе.
    
    Броски:
    
    NullPointerException - если ключ null
    
    См. Также:
    
    contains(Object)
  - добраться
```
public V get(Object key)
```
    Возвращает значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа.
    Более формально, если эта карта содержит отображение от ключа k к значению v так, что (key.equals(k)), тогда этот метод возвраты v; иначе это возвращается null. (Может быть самое большее одно такое отображение.)
    
    Определенный:
    
    get в интерфейсе Map<K,V>
    
    Определенный:
    
    get в class Dictionary<K,V>
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено
    
    Возвраты:
    
    значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа
    
    Броски:
    
    NullPointerException - если указанный ключ является нулем
    
    См. Также:
    
    put(Object, Object)
  - перефразировка
```
protected void rehash()
```
    Увеличивает емкость и внутренне реорганизовывает эту хеш-таблицу, чтобы разместить и получить доступ к ее записям более эффективно. Этот метод вызывают автоматически, когда число ключей в хеш-таблице превышает коэффициент нагрузки этой хеш-таблицы и коэффициент загрузки.
  - поместить
```
public V put(K key,
             V value)
```
    Отображает указанное key к указанному value в этой хеш-таблице. Ни ключ, ни значение не могут быть null.
    Значение может быть получено, вызывая get метод с ключом, который равен исходному ключу.
    
    Определенный:
    
    put в интерфейсе Map<K,V>
    
    Определенный:
    
    put в class Dictionary<K,V>
    
    Параметры:
    
    key - ключ хеш-таблицы
    
    value - значение
    
    Возвраты:
    
    предыдущее значение указанного ключа в этой хеш-таблице, или null если у этого не было того
    
    Броски:
    
    NullPointerException - если ключ или значение null
    
    См. Также:
    
    Object.equals(Object), get(Object)
  - удалить
```
public V remove(Object key)
```
    Удаляет ключ (и его соответствующее значение) от этой хеш-таблицы. Этот метод ничего не делает, если ключ не находится в хеш-таблице.
    
    Определенный:
    
    remove в интерфейсе Map<K,V>
    
    Определенный:
    
    remove в class Dictionary<K,V>
    
    Параметры:
    
    key - ключ, который должен быть удален
    
    Возвраты:
    
    значение, на которое ключ был отображен в этой хеш-таблице, или null если у ключа не было отображения
    
    Броски:
    
    NullPointerException - если ключ null
  - putAll
```
public void putAll(Map<? extends K,? extends V> t)
```
    Копии все отображения от указанной карты до этой хеш-таблицы. Эти отображения заменят любые отображения, которые эта хеш-таблица имела для любого из ключей в настоящий момент в указанной карте.
    
    Определенный:
    
    putAll в интерфейсе Map<K,V>
    
    Параметры:
    
    t - отображения, которые будут сохранены в этой карте
    
    Броски:
    
    NullPointerException - если указанная карта является нулем
    
    С тех пор:
    
    1.2
  - очистить
```
public void clear()
```
    Очищает эту хеш-таблицу так, чтобы она не содержала ключей.
    
    Определенный:
    
    clear в интерфейсе Map<K,V>
  - клон
```
public Object clone()
```
    Создает мелкую копию этой хеш-таблицы. Вся структура самой хеш-таблицы копируется, но ключи и значения не клонируются. Это - относительно дорогая работа.
    
    Переопределения:
    
    clone в class Object
    
    Возвраты:
    
    клон хеш-таблицы
    
    См. Также:
    
    Cloneable
  - toString
```
public String toString()
```
    Возвращает строковое представление этого объекта Hashtable в форме ряда записей, включенных в фигурные скобки и разделенный символами ASCII " , " (запятая и пространство). Каждая запись представляется, поскольку ключ, равняется знаку =, и связанный элемент, где метод toString используется, чтобы преобразовать ключ и элемент к строкам.
    
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    строковое представление этой хеш-таблицы
  - набор ключей
```
public Set<K> keySet()
```
    Возвраты a Set представление ключей содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме посредством собственной работы remove iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и операции clear. Это не поддерживает операции addAll или add.
    
    Определенный:
    
    keySet в интерфейсе Map<K,V>
    
    Возвраты:
    
    представление набора ключей содержится в этой карте
    
    С тех пор:
    
    1.2
  - entrySet
```
public Set<Map.Entry<K,V>> entrySet()
```
    Возвраты a Set представление отображений содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме посредством собственной работы remove iterator, или посредством работы setValue на записи карты, возвращенной iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll и операции clear. Это не поддерживает операции addAll или add.
    
    Определенный:
    
    entrySet в интерфейсе Map<K,V>
    
    Возвраты:
    
    представление набора отображений содержится в этой карте
    
    С тех пор:
    
    1.2
  - значения
```
public Collection<V> values()
```
    Возвраты a Collection представление значений содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме посредством собственной работы remove iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Collection.remove, removeAll, retainAll и операции clear. Это не поддерживает операции addAll или add.
    
    Определенный:
    
    values в интерфейсе Map<K,V>
    
    Возвраты:
    
    представление набора значений содержится в этой карте
    
    С тех пор:
    
    1.2
  - равняется
```
public boolean equals(Object o)
```
    Сравнивает указанный Объект с этой Картой для равенства, согласно определению в интерфейсе Карты.
    
    Определенный:
    
    equals в интерфейсе Map<K,V>
    
    Переопределения:
    
    equals в class Object
    
    Параметры:
    
    o - объект, который будет сравнен для равенства с этой хеш-таблицей
    
    Возвраты:
    
    истина, если указанный Объект равен этой Карте
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    Map.equals(Object)
  - хэш-код
```
public int hashCode()
```
    Возвращает значение хэш-кода для этой Карты согласно определению в интерфейсе Карты.
    
    Определенный:
    
    hashCode в интерфейсе Map<K,V>
    
    Переопределения:
    
    hashCode в class Object
    
    Возвраты:
    
    значение хэш-кода для этого объекта.
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    Map.hashCode()
  - getOrDefault
```
public V getOrDefault(Object key,
                      V defaultValue)
```
    Описание скопировало с интерфейса: Map
    
    Возвращает значение, на которое указанный ключ отображается, или defaultValue если эта карта не содержит отображения для ключа.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма.
    
    Определенный:
    
    getOrDefault в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено
    
    Возвраты:
    
    значение, на которое указанный ключ отображается, или defaultValue если эта карта не содержит отображения для ключа
  - forEach
```
public void forEach(BiConsumer<? super K,? super V> action)
```
    Описание скопировало с интерфейса: Map
    
    Выполняет данное действие на каждой записи в этой карте, в порядке, записи возвращаются набором записи iterator (который может быть неуказанным), пока все записи не были обработаны, или действие бросает Exception. Исключения, выданные действием, передаются к вызывающей стороне.
    Реализация по умолчанию должна быть переопределена реализациями, если они могут обеспечить более производительную реализацию чем iterator-на-основе.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма.
    
    Определенный:
    
    forEach в интерфейсе Map<K,V>
    
    Параметры:
    
    action - Действие, которое будет выполнено для каждой записи
  - replaceAll
```
public void replaceAll(BiFunction<? super K,? super V,? extends V> function)
```
    Описание скопировало с интерфейса: Map
    
    Замены значение каждой записи с результатом вызова заданной функции на той записи, в записях порядка возвращаются набором записи iterator, до всех записей, были обработаны, или функция выдает исключение.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма.
    
    Определенный:
    
    replaceAll в интерфейсе Map<K,V>
    
    Параметры:
    
    function - функция, чтобы примениться к каждой записи
  - putIfAbsent
```
public V putIfAbsent(K key,
                     V value)
```
    Описание скопировало с интерфейса: Map
    
    Если указанный ключ уже не связывается со значением (или отображается на null) партнеры это с данным значением и возвратами null, еще возвращает текущую стоимость.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма.
    
    Определенный:
    
    putIfAbsent в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым должно быть связано указанное значение
    
    value - значение, которое будет связано с указанным ключом
    
    Возвраты:
    
    предыдущее значение, связанное с указанным ключом, или 1 если не было никакого отображения для ключа. (A null возврат может также указать что карта, ранее связанная null с ключом, если реализация поддерживает нулевые значения.)
  - удалить
```
public boolean remove(Object key,
                      Object value)
```
    Описание скопировало с интерфейса: Map
    
    Удаляет запись для указанного ключа, только если это в настоящий момент отображается на указанное значение.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма.
    
    Определенный:
    
    remove в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым связывается указанное значение
    
    value - значение, которое, как ожидают, будет связано с указанным ключом
    
    Возвраты:
    
    true если значение было удалено
  - замена
```
public boolean replace(K key,
                       V oldValue,
                       V newValue)
```
    Описание скопировало с интерфейса: Map
    
    Заменяет запись для указанного ключа только если в настоящий момент отображенный на указанное значение.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма.
    
    Определенный:
    
    replace в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым связывается указанное значение
    
    oldValue - значение, которое, как ожидают, будет связано с указанным ключом
    
    newValue - значение, которое будет связано с указанным ключом
    
    Возвраты:
    
    true если значение было заменено
  - замена
```
public V replace(K key,
                 V value)
```
    Описание скопировало с интерфейса: Map
    
    Заменяет запись для указанного ключа, только если это в настоящий момент отображается на некоторое значение.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма.
    
    Определенный:
    
    replace в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым связывается указанное значение
    
    value - значение, которое будет связано с указанным ключом
    
    Возвраты:
    
    предыдущее значение, связанное с указанным ключом, или null если не было никакого отображения для ключа. (A null возврат может также указать что карта, ранее связанная null с ключом, если реализация поддерживает нулевые значения.)
  - computeIfAbsent
```
public V computeIfAbsent(K key,
                         Function<? super K,? extends V> mappingFunction)
```
    Описание скопировало с интерфейса: Map
    Если указанный ключ уже не связывается со значением (или отображается на null), пытается вычислить его значение, используя данную отображающуюся функцию и не вводит это в эту карту если null.
    Если функция возвращается null никакое отображение не записывается. Если сама функция выдает исключение (непроверенное), исключение повторно бросается, и никакое отображение не записывается. Наиболее распространенное использование должно создать новый объект, служащий начальной буквой отображенное значение или результат memoized, как в:
```
 
 map.computeIfAbsent(key, k -> new Value(f(k)));
 
```
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма. В частности все реализации подынтерфейса ConcurrentMap должен задокументировать, применяется ли функция однажды атомарно, только если значение не присутствует. Любой class, который разрешает нулевые значения, должен задокументировать, ли и как этот метод отличает отсутствие в нулевых отображениях.
    Определенный:
    
    computeIfAbsent в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым должно быть связано указанное значение
    
    mappingFunction - функция, чтобы вычислить значение
    
    Возвраты:
    
    ток (существующий или вычисленный) значение, связанное с указанным ключом, или нулем, если вычисленное значение является нулем
  - computeIfPresent
```
public V computeIfPresent(K key,
                          BiFunction<? super K,? super V,? extends V> remappingFunction)
```
    Описание скопировало с интерфейса: Map
    
    Если значение для указанного ключа присутствует и является ненулем, попытки вычислить новое отображение, данное ключ и его ток отображенное значение.
    Если функция возвращается null, отображение удаляется. Если сама функция выдает исключение (непроверенное), исключение повторно бросается, и текущее отображение оставляют неизменным.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма. В частности все реализации подынтерфейса ConcurrentMap должен задокументировать, применяется ли функция однажды атомарно, только если значение не присутствует. Любой class, который разрешает нулевые значения, должен задокументировать, ли и как этот метод отличает отсутствие в нулевых отображениях.
    
    Определенный:
    
    computeIfPresent в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым должно быть связано указанное значение
    
    remappingFunction - функция, чтобы вычислить значение
    
    Возвраты:
    
    новое значение, связанное с указанным ключом, или нулем, если ни один
  - вычислить
```
public V compute(K key,
                 BiFunction<? super K,? super V,? extends V> remappingFunction)
```
    Описание скопировало с интерфейса: Map
    Попытки вычислить отображение для указанного ключа и его тока отображенное значение (или null если нет никакого текущего отображения). Например, чтобы или создать или добавить a String msg к построению карты ценности:
```
 
 map.compute(key, (k, v) -> (v == null) ? msg : v.concat(msg))
```
    (Метод merge() часто более просто использовать в таких целях.)
    Если функция возвращается null, отображение удаляется (или остается отсутствующим если первоначально отсутствующий). Если сама функция выдает исключение (непроверенное), исключение повторно бросается, и текущее отображение оставляют неизменным.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма. В частности все реализации подынтерфейса ConcurrentMap должен задокументировать, применяется ли функция однажды атомарно, только если значение не присутствует. Любой class, который разрешает нулевые значения, должен задокументировать, ли и как этот метод отличает отсутствие в нулевых отображениях.
    Определенный:
    
    compute в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым должно быть связано указанное значение
    
    remappingFunction - функция, чтобы вычислить значение
    
    Возвраты:
    
    новое значение, связанное с указанным ключом, или нулем, если ни один
  - слияние
```
public V merge(K key,
               V value,
               BiFunction<? super V,? super V,? extends V> remappingFunction)
```
    Описание скопировало с интерфейса: Map
    Если указанный ключ уже не связывается со значением или связывается с нулем, партнеры он с данным значением. Иначе, заменяет значение результатами данной повторно отображающейся функции, или удаляет, если результат null. Этот метод может быть полезным, комбинируя многократные отображенные значения для ключа. Например, чтобы или создать или добавить a String msg к построению карты ценности:
```
 
 map.merge(key, msg, String::concat)
 
```
    Если функция возвращается null, отображение удаляется (или остается отсутствующим если первоначально отсутствующий). Если сама функция выдает исключение (непроверенное), исключение повторно бросается, и текущее отображение оставляют неизменным.
    Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма. В частности все реализации подынтерфейса ConcurrentMap должен задокументировать, применяется ли функция однажды атомарно, только если значение не присутствует. Любой class, который разрешает нулевые значения, должен задокументировать, ли и как этот метод отличает отсутствие в нулевых отображениях.
    Определенный:
    
    merge в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым должно быть связано указанное значение
    
    value - значение, чтобы использовать если отсутствующий
    
    remappingFunction - функция, чтобы повторно вычислить значение, если существующий
    
    Возвраты:
    
    новое значение, связанное с указанным ключом, или нулем, если ни один

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Хеш-таблица класса <K, V>

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Деталь конструктора

Хеш-таблица

Хеш-таблица

Хеш-таблица

Хеш-таблица

Деталь метода

размер

isEmpty

ключи

элементы

содержит

containsValue

containsKey

добраться

перефразировка

поместить

удалить

putAll

очистить

клон

toString

набор ключей

entrySet

значения

равняется

хэш-код

getOrDefault

forEach

replaceAll

putIfAbsent

удалить

замена

замена

computeIfAbsent

computeIfPresent

вычислить

слияние