1adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/* 2adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 3adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 4adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this work for additional information regarding copyright ownership. 5adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 6adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * (the "License"); you may not use this file except in compliance with 7adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the License. You may obtain a copy of the License at 8adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 9adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 10adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * See the License for the specific language governing permissions and 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * limitations under the License. 16adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 17adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 18adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage java.util; 19adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 20adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 21adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 22adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * A {@code Map} is a data structure consisting of a set of keys and values 23adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * in which each key is mapped to a single value. The class of the objects 24f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * used as keys is declared when the {@code Map} is declared, as is the 25adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * class of the corresponding values. 26f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * <p> 27f5597e626ecf7949d249dea08c1a2964d890ec11Jesse Wilson * A {@code Map} provides helper methods to iterate through all of the 28f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * keys contained in it, as well as various methods to access and update 29f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * the key/value pairs. 30adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 31adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic interface Map<K,V> { 32adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 33adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 34adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code Map.Entry} is a key/value mapping contained in a {@code Map}. 35adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 36adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static interface Entry<K,V> { 37adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 38adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Compares the specified object to this {@code Map.Entry} and returns if they 39adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * are equal. To be equal, the object must be an instance of {@code Map.Entry} and have the 40adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * same key and value. 41f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param object 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the {@code Object} to compare with this {@code Object}. 44adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if the specified {@code Object} is equal to this 45adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code Map.Entry}, {@code false} otherwise. 46adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #hashCode() 47adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 48adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean equals(Object object); 49adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 50adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 51adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the key. 52f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 53adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the key 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 55adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public K getKey(); 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 57adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 58adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the value. 59f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 60adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value 61adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 62adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public V getValue(); 63adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns an integer hash code for the receiver. {@code Object} which are 66adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * equal return the same value for this method. 67f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 68adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the receiver's hash code. 69adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #equals(Object) 70adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 71adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int hashCode(); 72adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 73adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 74adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the value of this entry to the specified value, replacing any 75adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * existing value. 76f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 77adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param object 78adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the new value to set. 79adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return object the replaced value of this entry. 80adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 81adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public V setValue(V object); 82adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project }; 83adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 84adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 85adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Removes all elements from this {@code Map}, leaving it empty. 86f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 87adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws UnsupportedOperationException 88adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if removing elements from this {@code Map} is not supported. 89adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #isEmpty() 90adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #size() 91adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 92adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void clear(); 93adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 94adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 95adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns whether this {@code Map} contains the specified key. 96f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 97adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param key 98adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the key to search for. 99adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if this map contains the specified key, 100adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code false} otherwise. 101adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 102adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean containsKey(Object key); 103adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 104adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 105adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns whether this {@code Map} contains the specified value. 106f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 107adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param value 108adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the value to search for. 109adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if this map contains the specified value, 110adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code false} otherwise. 111adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 112adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean containsValue(Object value); 113adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 114adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 115adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns a {@code Set} containing all of the mappings in this {@code Map}. Each mapping is 116adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * an instance of {@link Map.Entry}. As the {@code Set} is backed by this {@code Map}, 117adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * changes in one will be reflected in the other. 118f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 119adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return a set of the mappings 120adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 121adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Set<Map.Entry<K,V>> entrySet(); 122adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 123adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 124adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Compares the argument to the receiver, and returns {@code true} if the 125adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * specified object is a {@code Map} and both {@code Map}s contain the same mappings. 126f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 127adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param object 128adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the {@code Object} to compare with this {@code Object}. 129adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return boolean {@code true} if the {@code Object} is the same as this {@code Object} 130adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code false} if it is different from this {@code Object}. 131adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #hashCode() 132adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #entrySet() 133adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 134adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean equals(Object object); 135adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 136adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 137adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the value of the mapping with the specified key. 138f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 139adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param key 140adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the key. 141adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the mapping with the specified key, or {@code null} 142adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if no mapping for the specified key is found. 143adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 144adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public V get(Object key); 145adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 146adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 147adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns an integer hash code for the receiver. {@code Object}s which are equal 148adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * return the same value for this method. 149f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 150adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the receiver's hash. 151adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #equals(Object) 152adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 153adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int hashCode(); 154adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 155adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 156adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns whether this map is empty. 157f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 158adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return {@code true} if this map has no elements, {@code false} 159adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * otherwise. 160adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @see #size() 161adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 162adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public boolean isEmpty(); 163adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 164adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 165adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns a set of the keys contained in this {@code Map}. The {@code Set} is backed by 166adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this {@code Map} so changes to one are reflected by the other. The {@code Set} does not 167adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * support adding. 168f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 169adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return a set of the keys. 170adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 171adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Set<K> keySet(); 172adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 173adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 174adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Maps the specified key to the specified value. 175f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 176adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param key 177adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the key. 178adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param value 179adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the value. 180adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of any previous mapping with the specified key or 181adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code null} if there was no mapping. 182adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws UnsupportedOperationException 183adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if adding to this {@code Map} is not supported. 184adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws ClassCastException 185adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the class of the key or value is inappropriate for 186adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this {@code Map}. 187adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalArgumentException 188adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the key or value cannot be added to this {@code Map}. 189adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws NullPointerException 190adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the key or value is {@code null} and this {@code Map} does 191adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * not support {@code null} keys or values. 192adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 193adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public V put(K key, V value); 194adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 195adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 196adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Copies every mapping in the specified {@code Map} to this {@code Map}. 197f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 198adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param map 199adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the {@code Map} to copy mappings from. 200adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws UnsupportedOperationException 201adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if adding to this {@code Map} is not supported. 202adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws ClassCastException 203adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if the class of a key or a value of the specified {@code Map} is 204adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * inappropriate for this {@code Map}. 205adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IllegalArgumentException 206adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if a key or value cannot be added to this {@code Map}. 207adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws NullPointerException 208adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if a key or value is {@code null} and this {@code Map} does not 209adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * support {@code null} keys or values. 210adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 211adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void putAll(Map<? extends K,? extends V> map); 212adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 213adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 214adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Removes a mapping with the specified key from this {@code Map}. 215f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 216adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param key 217adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the key of the mapping to remove. 218adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the value of the removed mapping or {@code null} if no mapping 219adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * for the specified key was found. 220adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws UnsupportedOperationException 221adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if removing from this {@code Map} is not supported. 222adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 223adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public V remove(Object key); 224adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 225adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 226adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the number of mappings in this {@code Map}. 227f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 228adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the number of mappings in this {@code Map}. 229adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 230adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public int size(); 231adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 232adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 233adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns a {@code Collection} of the values contained in this {@code Map}. The {@code Collection} 234adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * is backed by this {@code Map} so changes to one are reflected by the other. The 235f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * {@code Collection} supports {@link Collection#remove}, {@link Collection#removeAll}, 236adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@link Collection#retainAll}, and {@link Collection#clear} operations, 237adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * and it does not support {@link Collection#add} or {@link Collection#addAll} operations. 238adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 239adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * This method returns a {@code Collection} which is the subclass of 240adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@link AbstractCollection}. The {@link AbstractCollection#iterator} method of this subclass returns a 241adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * "wrapper object" over the iterator of this {@code Map}'s {@link #entrySet()}. The {@link AbstractCollection#size} method 242adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * wraps this {@code Map}'s {@link #size} method and the {@link AbstractCollection#contains} method wraps this {@code Map}'s 243adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@link #containsValue} method. 244adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 245adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The collection is created when this method is called at first time and 246adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * returned in response to all subsequent calls. This method may return 247adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * different Collection when multiple calls to this method, since it has no 248adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * synchronization performed. 249f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 250adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return a collection of the values contained in this map. 251adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 252adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Collection<V> values(); 253adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 254