scala.collection.generic.GenericCompanion

abstract class GenericCompanion[+CC[X] <: GenTraversable[X]] extends AnyRef

A template class for companion objects of “regular” collection classes represent an unconstrained higher-kinded type. Typically such classes inherit from trait GenericTraversableTemplate .

Type Members

type Coll = CC[_]

The underlying collection type with unknown element type

  • Attributes
    • protected[this]

Abstract Value Members From scala.collection.generic.GenericCompanion

abstract def newBuilder[A]: Builder[A, CC[A]]

The default builder for CC objects.

  • A
    • the type of the collection’s elements

(defined at scala.collection.generic.GenericCompanion)

Concrete Value Members From scala.collection.generic.GenericCompanion

def apply[A](elems: A*): CC[A]

Creates a collection with the specified elements.

  • A
    • the type of the collection’s elements
  • elems
    • the elements of the created collection
  • returns
    • a new collection with elements elems

(defined at scala.collection.generic.GenericCompanion)

Instance Constructors From scala.collection.generic.GenericCompanion

new GenericCompanion()

(defined at scala.collection.generic.GenericCompanion)

Full Source:

/*                     __                                               *\
**     ________ ___   / /  ___     Scala API                            **
**    / __/ __// _ | / /  / _ |    (c) 2003-2013, LAMP/EPFL             **
**  __\ \/ /__/ __ |/ /__/ __ |    http://scala-lang.org/               **
** /____/\___/_/ |_/____/_/ | |                                         **
**                          |/                                          **
\*                                                                      */

package scala
package collection
package generic

import mutable.Builder
import scala.language.higherKinds

/** A template class for companion objects of "regular" collection classes
 *  represent an unconstrained higher-kinded type. Typically
 *  such classes inherit from trait `GenericTraversableTemplate`.
 *  @tparam  CC   The type constructor representing the collection class.
 *  @see [[scala.collection.generic.GenericTraversableTemplate]]
 *  @author Martin Odersky
 *  @since 2.8
 *  @define coll  collection
 *  @define Coll  `CC`
 */
abstract class GenericCompanion[+CC[X] <: GenTraversable[X]] {
  /** The underlying collection type with unknown element type */
  protected[this] type Coll = CC[_]

  /** The default builder for `$Coll` objects.
   *  @tparam A      the type of the ${coll}'s elements
   */
  def newBuilder[A]: Builder[A, CC[A]]

  /** An empty collection of type `$Coll[A]`
   *  @tparam A      the type of the ${coll}'s elements
   */
  def empty[A]: CC[A] = newBuilder[A].result()

  /** Creates a $coll with the specified elements.
   *  @tparam A      the type of the ${coll}'s elements
   *  @param elems  the elements of the created $coll
   *  @return a new $coll with elements `elems`
   */
  def apply[A](elems: A*): CC[A] = {
    if (elems.isEmpty) empty[A]
    else {
      val b = newBuilder[A]
      b ++= elems
      b.result()
    }
  }
}