put()API的说明

矫情吗；* 2022-05-18 07:20 193阅读 0赞

put()API的说明  
   /\*\*V put(K key, V value);  
     \* Associates the specified value with the specified key in this map  
       将特定的值和特定的键在这个映射中关联起来  
     \* (optional operation).  If the map previously contained a mapping for  
       如果这个映射明显包含对这个键的映射  
     \* the key, the old value is replaced by the specified value.  (A map  
       那么这个旧值就会被新的这个指定的值代替  
     \* <tt>m</tt> is said to contain a mapping for a key <tt>k</tt> if and only  
     \* if \{@link \#containsKey(Object) m.containsKey(k)\} would return  
     \* <tt>true</tt>.)  
     \* 参数和返回值  
     \* @param key key with which the specified value is to be associated  
                  特定值要对应的键  
     \* @param value value to be associated with the specified key  
                  特定键要对应的值  
     \* @return the previous value associated with <tt>key</tt>, or  
               返回之前与键key对应的值或者返回null  
     \*         <tt>null</tt> if there was no mapping for <tt>key</tt>.  
                如果没有对键key的映射  
     \*         (A <tt>null</tt> return can also indicate that the map  
               null返回也可以理解为  
     \*         previously associated <tt>null</tt> with <tt>key</tt>,  
               映射将null与key对应起来了  
     \*         if the implementation supports <tt>null</tt> values.)  
               如果实现支持null值的话  
     \* @throws UnsupportedOperationException if the <tt>put</tt> operation  
     \*         is not supported by this map  
       如果在这个映射不支持put操作将会抛出不支持操作异常  
     \* @throws ClassCastException if the class of the specified key or value  
     \*         prevents it from being stored in this map  
       如果值或者键的类阻止键或值存储在这个映射中将会抛出ClassCastException异常  
     \* @throws NullPointerException if the specified key or value is null  
     \*         and this map does not permit null keys or values  
      如果特定的值或键为null且这个映射不允许null键或null值就抛出NullPointerException异常  
     \* @throws IllegalArgumentException if some property of the specified key  
     \*         or value prevents it from being stored in this map  
     \*如果特定的键或者值的某些属性阻止键或值存储在这个映射中就会抛出IllegalArgumentException异常