Scaladoc 解码指环

Scaladoc 解码指环

本文内容来自<快学Scala>

Scaladoc	解读
def append(elems: A): Unit	这个方法接受零或多个类型为A的参数。举例来说:b.append(1, 7, 2, 9)将对b追加四个元素
def appendAll(xs: TraversableOnee[A]):Unit	xs参数可以是任何帶有TraversableOnce特质的集合，该特质是Scala集合层级中最通用的一个。 其他你还可能在Scaladoc中遇到的通用特质有Traversable和Iterable。所有的Scala集合都实现这些特质，至于它们之间有什么区别，对于类库的使用者而言属于科研话题，你只需要把它们当做是在说“任意集合”即不过，Seq特质需要元素能够通过整数下标访问。对应“数组、列表或字符申”
def count(p: (A) => Boolean): Int	这个方法接受一个前提作为参数，这是一个从A到Boolean的函数。count函数用于清点有多少元素在应用该函数后得到true。举例来说，a.count(_ > 0)的意思是清点有多少a的元素是正值
def ± (clem: A): ArrayBuffer.this.type	该方法返回this,让我们可以把调用串接起来，例如: b+=4-=5。在操作ArrayBuffer[A]时，我们可以简单地把这个方法当做:def += (elem: A): ArrayBuffer [A]如果有人构造出一个ArayBuffer的子类，那么+=的返回值就是那个子类
def copyToArray[B>: A] (xs: Array[B]):Unit	注意这个函数将一个ArrayBuffer[A]拷贝成一个Array[B]。这里的B仅允许为A的超类。举例来说，你可以把一个ArrayBuffer[Int]拷贝成-一个Array[Any]。初看时，可以忽略[B>:A],并把B替换成A
def max[B >: A] (implicit emp:Ordering[B]): A	A必须有一个超类B，并且存在一个类型为Ordering[B]的“隐式”对象。这样的顺序信息适用于数字、字符串以及其他带有Ordered特质的类型，同时也适用于那些实现了Java Comparable接口的类
def padTo[B >: A, That](len: Int, elem: B)(implicit bf: CanBuildFrom[ArrayBuffer[A], B, That]): That	这个声明涉及使用该方法创建新集合的过程的细节。你可以先跳过这个方法，找到更简单的版本，拿本例来说就是:def padTo (len: Int， elem: A): ArrayBuffer [A]未来的Scaladoc会把这些声明隐藏起来