add(E e)API中文翻译说明

矫情吗；* 2022-05-18 08:09 211阅读 0赞

/\*\*  1.  boolean add(E e);  
     \* Appends the specified element to the end of this list (optional  
     \* operation).  
     \* 添加一个指定的具体的元素到作为当前调用者的集合的末尾  
     \* <p>Lists that support this operation may place limitations on what  
       支持该操作的集合一般都会设置对添加到当前集合中的元素的数据类型进行设置  
     \* elements may be added to this list.  In particular, some  
       在特别情况下,一些  
     \* lists will refuse to add null elements, and others will impose  
       集合会拒绝添加null元素,而其他的集合会对要添加进来的元素的类型指明  
     \* restrictions on the type of elements that may be added.  List  
       限制  
     \* classes should clearly specify in their documentation any restrictions  
       集合类应该在声明文件中明确地指明对要添加进来的元素进行限制  
     \* on what elements may be added.  
     \*  
     \* @param e element to be appended to this list  
       注:参数e 表示 要被添加到当前集合的一个元素  
     \* @return <tt>true</tt> (as specified by \{@link Collection\#add\})  
       注:返回值 true  
     \* @throws UnsupportedOperationException if the <tt>add</tt> operation  
     \*         is not supported by this list  
       注:如果add操作方法不被该集合支持的话,将抛出UnsupportedOperationException异常  
     \* @throws ClassCastException if the class of the specified element  
     \*         prevents it from being added to this list  
       注:如果类组织某个特定的具体的元素添加到当前集合中那么将抛出ClassCastException异常  
     \* @throws NullPointerException if the specified element is null and this  
     \*         list does not permit null elements  
       注:如果特定的元素是null值 且 当前集合不允许null值元素将抛出NullPointerException异常  
     \* @throws IllegalArgumentException if some property of this element  
     \*         prevents it from being added to this list  
       如果当前元素的某属性阻止其被添加到集合中,那么将抛出IllegalArgumentException异常  
     \*/