blob: 700495204040a54318954a0a3ec7b58ea21fe56e (
plain) (
tree)
|
|
/* __ *\
** ________ ___ / / ___ Scala API **
** / __/ __// _ | / / / _ | (c) 2003-2009, LAMP/EPFL **
** __\ \/ /__/ __ |/ /__/ __ | http://scala-lang.org/ **
** /____/\___/_/ |_/____/_/ | | **
** |/ **
\* */
// $Id$
package scala.collection.generic
import scala.collection._
/** This class represents collections that can be augmented using a `+=` operator
* and that can be cleared of all elements using the `clear` method.
*
* @author Martin Odersky
* @owner Martin Odersky
* @version 2.8
*/
trait Growable[-A] {
/** Adds a single element to this collection.
*
* @param elem the element to add.
*/
def +=(elem: A): this.type
/** Adds two or more elements to this collection.
*
* @param elem1 the first element to add.
* @param elem2 the second element to add.
* @param elems the remaining elements to add.
*/
def +=(elem1: A, elem2: A, elems: A*): this.type = this += elem1 += elem2 ++= elems
/** Adds a number of elements provided by an iterator to this collection.
*
* @param iter the iterator.
*/
def ++=(iter: Iterator[A]): this.type = { iter foreach += ; this }
/** Adds a number of elements provided by an iterable object to this collection.
*
* @param iter the iterable object.
*/
def ++=(iter: Traversable[A]): this.type = { iter foreach +=; this }
/** Clears the collection contents.
*/
def clear()
}
|