blob: 655f1d12ac3035b37d2a875ec3c0dfefaf8fed66 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
/* __ *\
** ________ ___ / / ___ Scala API **
** / __/ __// _ | / / / _ | (c) 2003-2009, LAMP/EPFL **
** __\ \/ /__/ __ |/ /__/ __ | http://scala-lang.org/ **
** /____/\___/_/ |_/____/_/ | | **
** |/ **
\* */
// $Id$
package scala.collection
package mutable
import generic._
/** The base trait of all builders.
* A builder lets one construct a collection incrementally, by adding
* elements to the builder with += and then converting to the required
* collection type with `result`.
*
* @since 2.8
*/
trait Builder[-Elem, +To] extends Growable[Elem] {
/** Adds a single element to the builder.
* @param elem The element to be added
*/
def +=(elem: Elem): this.type
/** Clear the contents of this builder
*/
def clear()
/** Returns collection resulting from this builder. The buffer's contents
* are undefined afterwards.
*/
def result(): To
/** Give a hint how many elements are expected to be added
* when the next `result` is called.
*/
def sizeHint(size: Int) {}
/** Create a new builder which is the same as the current builder except
* that a given function is applied to the current builder's result.
* @param f the function to apply to the builder's result
*/
def mapResult[NewTo](f: To => NewTo): Builder[Elem, NewTo] =
new Builder[Elem, NewTo] with Proxy {
val self = Builder.this
def +=(x: Elem): this.type = { self += x; this }
def clear() = self.clear()
override def ++=(xs: Iterator[Elem]): this.type = { self ++= xs; this }
override def ++=(xs:scala.collection.Traversable[Elem]): this.type = { self ++= xs; this }
def result: NewTo = f(self.result)
}
}
|