scala.collection.immutable

Stream

object Stream extends SeqFactory[Stream]

The object Stream provides helper functions to manipulate streams.

Source
Stream.scala
Version

1.1 08/08/03

Since

2.8

Linear Supertypes
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Hide All
  2. Show all
  1. Stream
  2. SeqFactory
  3. TraversableFactory
  4. GenericSeqCompanion
  5. GenSeqFactory
  6. GenTraversableFactory
  7. GenericCompanion
  8. AnyRef
  9. Any
Visibility
  1. Public
  2. All

Type Members

  1. type Coll = scala.collection.immutable.Stream[_]

    The underlying collection type with unknown element type

    The underlying collection type with unknown element type

    Definition Classes
    GenericCompanion
  2. class Cons [+A] extends Stream[A] with Serializable

    A lazy cons cell, from which streams are built.

  3. class ConsWrapper [A] extends AnyRef

    A wrapper class that adds #:: for cons and #::: for concat as operations to streams.

  4. class GenericCanBuildFrom [A] extends CanBuildFrom[CC[_], A, CC[A]]

    A generic implementation of the CanBuildFrom trait, which forwards all calls to apply(from) to the genericBuilder method of collection from, and which forwards all calls of apply() to the newBuilder method of this factory.

  5. class StreamBuilder [A] extends LazyBuilder[A, Stream[A]]

    A builder for streams

  6. class StreamCanBuildFrom [A] extends GenericCanBuildFrom[A]

    The factory for streams.

Value Members

  1. def != (arg0: AnyRef): Boolean

    Attributes
    final
    Definition Classes
    AnyRef
  2. def != (arg0: Any): Boolean

    Test two objects for inequality.

    Test two objects for inequality.

    returns

    true if !(this == that), false otherwise.

    Attributes
    final
    Definition Classes
    Any
  3. def ## (): Int

    Equivalent to x.hashCode except for boxed numeric types.

    Equivalent to x.hashCode except for boxed numeric types. For numerics, it returns a hash value which is consistent with value equality: if two value type instances compare as true, then ## will produce the same hash value for each of them.

    returns

    a hash value consistent with ==

    Attributes
    final
    Definition Classes
    AnyRef → Any
  4. object #:: extends AnyRef

    An extractor that allows to pattern match streams with #::.

  5. def == (arg0: AnyRef): Boolean

    Attributes
    final
    Definition Classes
    AnyRef
  6. def == (arg0: Any): Boolean

    Test two objects for equality.

    Test two objects for equality.

    returns

    true if the receiver object is equivalent to the argument; false otherwise.

    Attributes
    final
    Definition Classes
    Any
  7. object Empty extends Stream[Nothing]

  8. def apply [A] (xs: A*): Stream[A]

    A stream consisting of given elements

    A stream consisting of given elements

    A

    the type of the collection's elements

    returns

    a new collection with elements elems

    Definition Classes
    StreamGenericSeqCompanionGenericCompanion
  9. def asInstanceOf [T0] : T0

    Cast the receiver object to be of type T0.

    Cast the receiver object to be of type T0.

    Note that the success of a cast at runtime is modulo Scala's erasure semantics. Therefore the expression 1.asInstanceOf[String] will throw a ClassCastException at runtime, while the expression List(1).asInstanceOf[List[String]] will not. In the latter example, because the type argument is erased as part of compilation it is not possible to check whether the contents of the list are of the requested type.

    returns

    the receiver object.

    Attributes
    final
    Definition Classes
    Any
  10. implicit def canBuildFrom [A] : CanBuildFrom[Coll, A, Stream[A]]

    Attributes
    implicit
  11. def clone (): AnyRef

    Create a copy of the receiver object.

    Create a copy of the receiver object.

    The default implementation of the clone method is platform dependent.

    returns

    a copy of the receiver object.

    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws()
  12. def concat [A] (xss: Traversable[A]*): Stream[A]

    Concatenates all argument collections into a single collection.

    Concatenates all argument collections into a single collection.

    xss

    the collections that are to be concatenated.

    returns

    the concatenation of all the collections.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  13. object cons extends AnyRef

    An alternative way of building and matching Streams using Stream.

  14. implicit def consWrapper [A] (stream: ⇒ Stream[A]): ConsWrapper[A]

    A wrapper method that adds #:: for cons and #::: for concat as operations to streams.

    A wrapper method that adds #:: for cons and #::: for concat as operations to streams.

    Attributes
    implicit
  15. def continually [A] (elem: ⇒ A): Stream[A]

    Create an infinite stream containing the given element expression (which is computed for each occurrence)

    Create an infinite stream containing the given element expression (which is computed for each occurrence)

    elem

    the element composing the resulting stream

    returns

    the stream containing an infinite number of elem

  16. def empty [A] : Stream[A]

    The empty stream

    The empty stream

    A

    the type of the collection's elements

    Definition Classes
    StreamGenericSeqCompanionGenericCompanion
  17. def eq (arg0: AnyRef): Boolean

    Tests whether the argument (arg0) is a reference to the receiver object (this).

    Tests whether the argument (arg0) is a reference to the receiver object (this).

    The eq method implements an equivalence relation on non-null instances of AnyRef, and has three additional properties:

    • It is consistent: for any non-null instances x and y of type AnyRef, multiple invocations of x.eq(y) consistently returns true or consistently returns false.
    • For any non-null instance x of type AnyRef, x.eq(null) and null.eq(x) returns false.
    • null.eq(null) returns true.

    When overriding the equals or hashCode methods, it is important to ensure that their behavior is consistent with reference equality. Therefore, if two objects are references to each other (o1 eq o2), they should be equal to each other (o1 == o2) and they should hash to the same value (o1.hashCode == o2.hashCode).

    returns

    true if the argument is a reference to the receiver object; false otherwise.

    Attributes
    final
    Definition Classes
    AnyRef
  18. def equals (arg0: Any): Boolean

    The equality method for reference types.

    The equality method for reference types. See equals in Any.

    returns

    true if the receiver object is equivalent to the argument; false otherwise.

    Definition Classes
    AnyRef → Any
  19. def fill [A] (n: Int)(elem: ⇒ A): Stream[A]

    Produces a collection containing the results of some element computation a number of times.

    Produces a collection containing the results of some element computation a number of times.

    n

    the number of elements contained in the collection.

    elem

    the element computation

    returns

    A collection that contains the results of n evaluations of elem.

    Definition Classes
    StreamTraversableFactoryGenTraversableFactory
  20. def fill [A] (n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(elem: ⇒ A): Stream[Stream[Stream[Stream[Stream[A]]]]]

    Produces a five-dimensional collection containing the results of some element computation a number of times.

    Produces a five-dimensional collection containing the results of some element computation a number of times.

    n1

    the number of elements in the 1st dimension

    n2

    the number of elements in the 2nd dimension

    n3

    the number of elements in the 3nd dimension

    n4

    the number of elements in the 4th dimension

    n5

    the number of elements in the 5th dimension

    elem

    the element computation

    returns

    A collection that contains the results of n1 x n2 x n3 x n4 x n5 evaluations of elem.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  21. def fill [A] (n1: Int, n2: Int, n3: Int, n4: Int)(elem: ⇒ A): Stream[Stream[Stream[Stream[A]]]]

    Produces a four-dimensional collection containing the results of some element computation a number of times.

    Produces a four-dimensional collection containing the results of some element computation a number of times.

    n1

    the number of elements in the 1st dimension

    n2

    the number of elements in the 2nd dimension

    n3

    the number of elements in the 3nd dimension

    n4

    the number of elements in the 4th dimension

    elem

    the element computation

    returns

    A collection that contains the results of n1 x n2 x n3 x n4 evaluations of elem.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  22. def fill [A] (n1: Int, n2: Int, n3: Int)(elem: ⇒ A): Stream[Stream[Stream[A]]]

    Produces a three-dimensional collection containing the results of some element computation a number of times.

    Produces a three-dimensional collection containing the results of some element computation a number of times.

    n1

    the number of elements in the 1st dimension

    n2

    the number of elements in the 2nd dimension

    n3

    the number of elements in the 3nd dimension

    elem

    the element computation

    returns

    A collection that contains the results of n1 x n2 x n3 evaluations of elem.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  23. def fill [A] (n1: Int, n2: Int)(elem: ⇒ A): Stream[Stream[A]]

    Produces a two-dimensional collection containing the results of some element computation a number of times.

    Produces a two-dimensional collection containing the results of some element computation a number of times.

    n1

    the number of elements in the 1st dimension

    n2

    the number of elements in the 2nd dimension

    elem

    the element computation

    returns

    A collection that contains the results of n1 x n2 evaluations of elem.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  24. def finalize (): Unit

    Called by the garbage collector on the receiver object when there are no more references to the object.

    Called by the garbage collector on the receiver object when there are no more references to the object.

    The details of when and if the finalize method is invoked, as well as the interaction between finalize and non-local returns and exceptions, are all platform dependent.

    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws()
  25. def from (start: Int): Stream[Int]

    Create an infinite stream starting at start and incrementing by 1.

    Create an infinite stream starting at start and incrementing by 1.

    start

    the start value of the stream

    returns

    the stream starting at value start.

  26. def from (start: Int, step: Int): Stream[Int]

    Create an infinite stream starting at start and incrementing by step step

    Create an infinite stream starting at start and incrementing by step step

    start

    the start value of the stream

    step

    the increment value of the stream

    returns

    the stream starting at value start.

  27. def getClass (): java.lang.Class[_ <: java.lang.Object]

    A representation that corresponds to the dynamic class of the receiver object.

    A representation that corresponds to the dynamic class of the receiver object.

    The nature of the representation is platform dependent.

    returns

    a representation that corresponds to the dynamic class of the receiver object.

    Attributes
    final
    Definition Classes
    AnyRef
  28. def hashCode (): Int

    The hashCode method for reference types.

    The hashCode method for reference types. See hashCode in Any.

    returns

    the hash code value for this object.

    Definition Classes
    AnyRef → Any
  29. def isInstanceOf [T0] : Boolean

    Test whether the dynamic type of the receiver object is T0.

    Test whether the dynamic type of the receiver object is T0.

    Note that the result of the test is modulo Scala's erasure semantics. Therefore the expression 1.isInstanceOf[String] will return false, while the expression List(1).isInstanceOf[List[String]] will return true. In the latter example, because the type argument is erased as part of compilation it is not possible to check whether the contents of the list are of the specified type.

    returns

    true if the receiver object is an instance of erasure of type T0; false otherwise.

    Attributes
    final
    Definition Classes
    Any
  30. def iterate [A] (start: A, len: Int)(f: (A) ⇒ A): Stream[A]

    Produces a collection containing repeated applications of a function to a start value.

    Produces a collection containing repeated applications of a function to a start value.

    start

    the start value of the collection

    len

    the number of elements contained inthe collection

    f

    the function that's repeatedly applied

    returns

    a collection with len values in the sequence start, f(start), f(f(start)), ...

    Definition Classes
    StreamTraversableFactoryGenTraversableFactory
  31. def iterate [A] (start: A)(f: (A) ⇒ A): Stream[A]

    An infinite stream that repeatedly applies a given function to a start value.

    An infinite stream that repeatedly applies a given function to a start value.

    start

    the start value of the stream

    f

    the function that's repeatedly applied

    returns

    the stream returning the infinite sequence of values start, f(start), f(f(start)), ...

  32. def ne (arg0: AnyRef): Boolean

    Equivalent to !(this eq that).

    Equivalent to !(this eq that).

    returns

    true if the argument is not a reference to the receiver object; false otherwise.

    Attributes
    final
    Definition Classes
    AnyRef
  33. def newBuilder [A] : Builder[A, Stream[A]]

    Creates a new builder for a stream

    Creates a new builder for a stream

    A

    the type of the collection's elements

    Definition Classes
    StreamGenericCompanion
  34. def notify (): Unit

    Wakes up a single thread that is waiting on the receiver object's monitor.

    Wakes up a single thread that is waiting on the receiver object's monitor.

    Attributes
    final
    Definition Classes
    AnyRef
  35. def notifyAll (): Unit

    Wakes up all threads that are waiting on the receiver object's monitor.

    Wakes up all threads that are waiting on the receiver object's monitor.

    Attributes
    final
    Definition Classes
    AnyRef
  36. def range [T] (start: T, end: T, step: T)(implicit arg0: Integral[T]): Stream[T]

    Produces a collection containing equally spaced values in some integer interval.

    Produces a collection containing equally spaced values in some integer interval.

    start

    the start value of the collection

    end

    the end value of the collection (the first value NOT contained)

    step

    the difference between successive elements of the collection (must be positive or negative)

    returns

    a collection with values start, start + step, ... up to, but excluding end

    Definition Classes
    StreamTraversableFactoryGenTraversableFactory
  37. def range [T] (start: T, end: T)(implicit arg0: Integral[T]): Stream[T]

    Produces a collection containing a sequence of increasing of integers.

    Produces a collection containing a sequence of increasing of integers.

    end

    the end value of the collection (the first value NOT contained)

    returns

    a collection with values start, start + 1, ..., end - 1

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  38. def synchronized [T0] (arg0: ⇒ T0): T0

    Attributes
    final
    Definition Classes
    AnyRef
  39. def tabulate [A] (n: Int)(f: (Int) ⇒ A): Stream[A]

    Produces a collection containing values of a given function over a range of integer values starting from 0.

    Produces a collection containing values of a given function over a range of integer values starting from 0.

    n

    The number of elements in the collection

    f

    The function computing element values

    returns

    A collection consisting of elements f(0), ..., f(n -1)

    Definition Classes
    StreamTraversableFactoryGenTraversableFactory
  40. def tabulate [A] (n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(f: (Int, Int, Int, Int, Int) ⇒ A): Stream[Stream[Stream[Stream[Stream[A]]]]]

    Produces a five-dimensional collection containing values of a given function over ranges of integer values starting from 0.

    Produces a five-dimensional collection containing values of a given function over ranges of integer values starting from 0.

    n1

    the number of elements in the 1st dimension

    n2

    the number of elements in the 2nd dimension

    n3

    the number of elements in the 3nd dimension

    n4

    the number of elements in the 4th dimension

    n5

    the number of elements in the 5th dimension

    f

    The function computing element values

    returns

    A collection consisting of elements f(i1, i2, i3, i4, i5) for 0 <= i1 < n1, 0 <= i2 < n2, 0 <= i3 < n3, 0 <= i4 < n4, and 0 <= i5 < n5.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  41. def tabulate [A] (n1: Int, n2: Int, n3: Int, n4: Int)(f: (Int, Int, Int, Int) ⇒ A): Stream[Stream[Stream[Stream[A]]]]

    Produces a four-dimensional collection containing values of a given function over ranges of integer values starting from 0.

    Produces a four-dimensional collection containing values of a given function over ranges of integer values starting from 0.

    n1

    the number of elements in the 1st dimension

    n2

    the number of elements in the 2nd dimension

    n3

    the number of elements in the 3nd dimension

    n4

    the number of elements in the 4th dimension

    f

    The function computing element values

    returns

    A collection consisting of elements f(i1, i2, i3, i4) for 0 <= i1 < n1, 0 <= i2 < n2, 0 <= i3 < n3, and 0 <= i4 < n4.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  42. def tabulate [A] (n1: Int, n2: Int, n3: Int)(f: (Int, Int, Int) ⇒ A): Stream[Stream[Stream[A]]]

    Produces a three-dimensional collection containing values of a given function over ranges of integer values starting from 0.

    Produces a three-dimensional collection containing values of a given function over ranges of integer values starting from 0.

    n1

    the number of elements in the 1st dimension

    n2

    the number of elements in the 2nd dimension

    n3

    the number of elements in the 3nd dimension

    f

    The function computing element values

    returns

    A collection consisting of elements f(i1, i2, i3) for 0 <= i1 < n1, 0 <= i2 < n2, and 0 <= i3 < n3.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  43. def tabulate [A] (n1: Int, n2: Int)(f: (Int, Int) ⇒ A): Stream[Stream[A]]

    Produces a two-dimensional collection containing values of a given function over ranges of integer values starting from 0.

    Produces a two-dimensional collection containing values of a given function over ranges of integer values starting from 0.

    n1

    the number of elements in the 1st dimension

    n2

    the number of elements in the 2nd dimension

    f

    The function computing element values

    returns

    A collection consisting of elements f(i1, i2) for 0 <= i1 < n1 and 0 <= i2 < n2.

    Definition Classes
    TraversableFactoryGenTraversableFactory
    Annotations
    @bridge()
  44. def toString (): String

    Creates a String representation of this object.

    Creates a String representation of this object. The default representation is platform dependent. On the java platform it is the concatenation of the class name, "@", and the object's hashcode in hexadecimal.

    returns

    a String representation of the object.

    Definition Classes
    AnyRef → Any
  45. def unapplySeq [A] (x: Stream[A]): Some[Stream[A]]

    This method is called in a pattern match { case Seq(.

    This method is called in a pattern match { case Seq(...) => }.

    x

    the selector value

    returns

    sequence wrapped in an option, if this is a Seq, otherwise none

    Definition Classes
    GenSeqFactory
  46. def wait (): Unit

    Attributes
    final
    Definition Classes
    AnyRef
    Annotations
    @throws()
  47. def wait (arg0: Long, arg1: Int): Unit

    Attributes
    final
    Definition Classes
    AnyRef
    Annotations
    @throws()
  48. def wait (arg0: Long): Unit

    Attributes
    final
    Definition Classes
    AnyRef
    Annotations
    @throws()
  49. def concat [A] (xs: Iterator[Stream[A]]): Stream[A]

    The concatenation of all streams returned by an iterator

    The concatenation of all streams returned by an iterator

    Annotations
    @deprecated
    Deprecated

    use xs.toStream.flatten instead

  50. def concat [A] (xs: Iterable[Stream[A]]): Stream[A]

    The concatenation of a sequence of streams

    The concatenation of a sequence of streams

    Annotations
    @deprecated
    Deprecated

    use xs.flatten instead

  51. def const [A] (elem: A): Stream[A]

    Create an infinite stream containing the given element.

    Create an infinite stream containing the given element.

    elem

    the element composing the resulting stream

    returns

    the stream containing an infinite number of elem

    Annotations
    @deprecated
    Deprecated

    use continually' instead

  52. def fromIterator [A] (it: Iterator[A]): Stream[A]

    A stream containing all elements of a given iterator, in the order they are produced.

    A stream containing all elements of a given iterator, in the order they are produced.

    it

    The iterator producing the stream's elements

    Annotations
    @deprecated
    Deprecated

    use it.toStream instead

  53. lazy val lazy_:: : #::

    Annotations
    @deprecated
    Deprecated

    use #:: instead

  54. def make [A] (n: Int, elem: A): Stream[A]

    Create a stream containing several copies of an element.

    Create a stream containing several copies of an element.

    n

    the length of the resulting stream

    elem

    the element composing the resulting stream

    returns

    the stream composed of n elements all equal to elem

    Annotations
    @deprecated
    Deprecated

    use fill(n, elem) instead

  55. def range (start: Int, end: Int, step: (Int) ⇒ Int): Stream[Int]

    Create a stream with element values vn+1 = step(vn) where v0 = start and elements are in the range between start (inclusive) and end (exclusive)

    Create a stream with element values vn+1 = step(vn) where v0 = start and elements are in the range between start (inclusive) and end (exclusive)

    start

    the start value of the stream

    end

    the end value of the stream

    step

    the increment function of the stream, must be monotonically increasing or decreasing

    returns

    the stream starting at value start.

    Annotations
    @deprecated
    Deprecated

    use iterate' instead.

Inherited from SeqFactory[Stream]

Inherited from TraversableFactory[Stream]

Inherited from GenericSeqCompanion[Stream]

Inherited from GenSeqFactory[Stream]

Inherited from GenTraversableFactory[Stream]

Inherited from GenericCompanion[Stream]

Inherited from AnyRef

Inherited from Any