object List extends StrictOptimizedSeqFactory[List]
This object provides a set of operations to create List
values.
- Annotations
- @SerialVersionUID()
- Source
- List.scala
- Alphabetic
- By Inheritance
- List
- StrictOptimizedSeqFactory
- SeqFactory
- IterableFactory
- Serializable
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Value Members
- def apply[A](elems: A*): List[A]
Creates a list with the specified elements.
Creates a list with the specified elements.
- A
the type of the list's elements
- elems
the elements of the created list
- returns
a new list with elements
elems
- Definition Classes
- IterableFactory
- def concat[A](xss: collection.Iterable[A]*): List[A]
Concatenates all argument collections into a single list.
Concatenates all argument collections into a single list.
- xss
the collections that are to be concatenated.
- returns
the concatenation of all the collections.
- Definition Classes
- StrictOptimizedSeqFactory → IterableFactory
- def empty[A]: List[A]
An empty collection
- def fill[A](n: Int)(elem: => A): List[A]
Produces a list containing the results of some element computation a number of times.
Produces a list containing the results of some element computation a number of times.
- n
the number of elements contained in the list.
- elem
the element computation
- returns
A list that contains the results of
n
evaluations ofelem
.
- Definition Classes
- StrictOptimizedSeqFactory → IterableFactory
- def fill[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(elem: => A): List[List[List[List[List[A]]]]]
Produces a five-dimensional list containing the results of some element computation a number of times.
Produces a five-dimensional list 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 3rd 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 list that contains the results of
n1 x n2 x n3 x n4 x n5
evaluations ofelem
.
- Definition Classes
- IterableFactory
- def fill[A](n1: Int, n2: Int, n3: Int, n4: Int)(elem: => A): List[List[List[List[A]]]]
Produces a four-dimensional list containing the results of some element computation a number of times.
Produces a four-dimensional list 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 3rd dimension
- n4
the number of elements in the 4th dimension
- elem
the element computation
- returns
A list that contains the results of
n1 x n2 x n3 x n4
evaluations ofelem
.
- Definition Classes
- IterableFactory
- def fill[A](n1: Int, n2: Int, n3: Int)(elem: => A): List[List[List[A]]]
Produces a three-dimensional list containing the results of some element computation a number of times.
Produces a three-dimensional list 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 3rd dimension
- elem
the element computation
- returns
A list that contains the results of
n1 x n2 x n3
evaluations ofelem
.
- Definition Classes
- IterableFactory
- def fill[A](n1: Int, n2: Int)(elem: => A): List[List[A]]
Produces a two-dimensional list containing the results of some element computation a number of times.
Produces a two-dimensional list 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 list that contains the results of
n1 x n2
evaluations ofelem
.
- Definition Classes
- IterableFactory
- def from[B](coll: IterableOnce[B]): List[B]
Creates a target list from an existing source collection
Creates a target list from an existing source collection
- returns
a new list with the elements of
source
- Definition Classes
- List → IterableFactory
- implicit def iterableFactory[A]: Factory[A, List[A]]
- Definition Classes
- IterableFactory
- def iterate[A](start: A, len: Int)(f: (A) => A): List[A]
Produces a list containing repeated applications of a function to a start value.
Produces a list containing repeated applications of a function to a start value.
- start
the start value of the list
- len
the number of elements contained in the list
- f
the function that's repeatedly applied
- returns
a list with
len
values in the sequencestart, f(start), f(f(start)), ...
- Definition Classes
- IterableFactory
- def newBuilder[A]: Builder[A, List[A]]
- A
the type of the list’s elements
- returns
A builder for
List
objects.
- Definition Classes
- List → IterableFactory
- def range[A](start: A, end: A, step: A)(implicit arg0: Integral[A]): List[A]
Produces a list containing equally spaced values in some integer interval.
Produces a list containing equally spaced values in some integer interval.
- start
the start value of the list
- end
the end value of the list (the first value NOT contained)
- step
the difference between successive elements of the list (must be positive or negative)
- returns
a list with values
start, start + step, ...
up to, but excludingend
- Definition Classes
- IterableFactory
- def range[A](start: A, end: A)(implicit arg0: Integral[A]): List[A]
Produces a list containing a sequence of increasing of integers.
Produces a list containing a sequence of increasing of integers.
- start
the first element of the list
- end
the end value of the list (the first value NOT contained)
- returns
a list with values
start, start + 1, ..., end - 1
- Definition Classes
- IterableFactory
- def tabulate[A](n: Int)(f: (Int) => A): List[A]
Produces a list containing values of a given function over a range of integer values starting from 0.
Produces a list containing values of a given function over a range of integer values starting from 0.
- n
The number of elements in the list
- f
The function computing element values
- returns
A list consisting of elements
f(0), ..., f(n -1)
- Definition Classes
- StrictOptimizedSeqFactory → IterableFactory
- def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(f: (Int, Int, Int, Int, Int) => A): List[List[List[List[List[A]]]]]
Produces a five-dimensional list containing values of a given function over ranges of integer values starting from 0.
Produces a five-dimensional list 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 3rd 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 list consisting of elements
f(i1, i2, i3, i4, i5)
for0 <= i1 < n1
,0 <= i2 < n2
,0 <= i3 < n3
,0 <= i4 < n4
, and0 <= i5 < n5
.
- Definition Classes
- IterableFactory
- def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int)(f: (Int, Int, Int, Int) => A): List[List[List[List[A]]]]
Produces a four-dimensional list containing values of a given function over ranges of integer values starting from 0.
Produces a four-dimensional list 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 3rd dimension
- n4
the number of elements in the 4th dimension
- f
The function computing element values
- returns
A list consisting of elements
f(i1, i2, i3, i4)
for0 <= i1 < n1
,0 <= i2 < n2
,0 <= i3 < n3
, and0 <= i4 < n4
.
- Definition Classes
- IterableFactory
- def tabulate[A](n1: Int, n2: Int, n3: Int)(f: (Int, Int, Int) => A): List[List[List[A]]]
Produces a three-dimensional list containing values of a given function over ranges of integer values starting from 0.
Produces a three-dimensional list 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 3rd dimension
- f
The function computing element values
- returns
A list consisting of elements
f(i1, i2, i3)
for0 <= i1 < n1
,0 <= i2 < n2
, and0 <= i3 < n3
.
- Definition Classes
- IterableFactory
- def tabulate[A](n1: Int, n2: Int)(f: (Int, Int) => A): List[List[A]]
Produces a two-dimensional list containing values of a given function over ranges of integer values starting from 0.
Produces a two-dimensional list 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 list consisting of elements
f(i1, i2)
for0 <= i1 < n1
and0 <= i2 < n2
.
- Definition Classes
- IterableFactory
- final def unapplySeq[A](x: List[A]): UnapplySeqWrapper[A]
- Definition Classes
- SeqFactory
- def unfold[A, S](init: S)(f: (S) => Option[(A, S)]): List[A]
Produces a list that uses a function
f
to produce elements of typeA
and update an internal state of typeS
.Produces a list that uses a function
f
to produce elements of typeA
and update an internal state of typeS
.- A
Type of the elements
- S
Type of the internal state
- init
State initial value
- f
Computes the next element (or returns
None
to signal the end of the collection)- returns
a list that produces elements using
f
untilf
returnsNone
- Definition Classes
- IterableFactory
This is the documentation for the Scala standard library.
Package structure
The scala package contains core types like
Int
,Float
,Array
orOption
which are accessible in all Scala compilation units without explicit qualification or imports.Notable packages include:
scala.collection
and its sub-packages contain Scala's collections frameworkscala.collection.immutable
- Immutable, sequential data-structures such asVector
,List
,Range
,HashMap
orHashSet
scala.collection.mutable
- Mutable, sequential data-structures such asArrayBuffer
,StringBuilder
,HashMap
orHashSet
scala.collection.concurrent
- Mutable, concurrent data-structures such asTrieMap
scala.concurrent
- Primitives for concurrent programming such asFutures
andPromises
scala.io
- Input and output operationsscala.math
- Basic math functions and additional numeric types likeBigInt
andBigDecimal
scala.sys
- Interaction with other processes and the operating systemscala.util.matching
- Regular expressionsOther packages exist. See the complete list on the right.
Additional parts of the standard library are shipped as separate libraries. These include:
scala.reflect
- Scala's reflection API (scala-reflect.jar)scala.xml
- XML parsing, manipulation, and serialization (scala-xml.jar)scala.collection.parallel
- Parallel collections (scala-parallel-collections.jar)scala.util.parsing
- Parser combinators (scala-parser-combinators.jar)scala.swing
- A convenient wrapper around Java's GUI framework called Swing (scala-swing.jar)Automatic imports
Identifiers in the scala package and the
scala.Predef
object are always in scope by default.Some of these identifiers are type aliases provided as shortcuts to commonly used classes. For example,
List
is an alias forscala.collection.immutable.List
.Other aliases refer to classes provided by the underlying platform. For example, on the JVM,
String
is an alias forjava.lang.String
.